create a "plain" style with next to no CSS

this clarifies the value of what was formerly "style.css" a bit, and
also opens the door for potential styles that don't inherit the base
styling at all

incorporealcms/config.py

@@ -48,7 +48,11 @@ class Config(object):
         },
     }
 
-    DEFAULT_PAGE_STYLE = 'light'
-
-    TITLE_SUFFIX = 'incorporeal.org'
     MEDIA_DIR = 'media'
+
+    # customizations
+    DEFAULT_PAGE_STYLE = 'light'
+    TITLE_SUFFIX = 'incorporeal.org'
+    CONTACT_EMAIL = 'bss@incorporeal.org'
+
+    # specify FAVICON in your instance config.py to override the suou icon

incorporealcms/lib.py

@@ -34,6 +34,7 @@ def render(template_name_or_list, **context):
     PAGE_STYLES = {
         'dark': 'css/dark.css',
         'light': 'css/light.css',
+        'plain': 'css/plain.css',
     }
 
     selected_style = request.args.get('style', None)

incorporealcms/pages.py

@@ -130,5 +130,13 @@ def generate_parent_navs(path):
         with app.open_instance_resource(path, 'r') as entry_file:
             entry = entry_file.read()
         _ = Markup(md.convert(entry))
-        page_name = " ".join(md.Meta.get('title')) if md.Meta.get('title') else request_path
+        page_name = (" ".join(md.Meta.get('title')) if md.Meta.get('title')
+                     else request_path_to_breadcrumb_display(request_path))
         return generate_parent_navs(parent_resource_path) + [(page_name, request_path)]
+
+
+def request_path_to_breadcrumb_display(path):
+    """Given a request path, e.g. "/foo/bar/baz/", turn it into breadcrumby text "baz"."""
+    undired = path.rstrip('/')
+    leaf = undired[undired.rfind('/'):]
+    return leaf.strip('/')

incorporealcms/static/css/dark.css

@@ -1,3 +1,5 @@
+@import '/static/css/base.css';
+
 html {
     color: #CCC;
 }

incorporealcms/static/css/light.css

@@ -1,3 +1,5 @@
+@import '/static/css/base.css';
+
 html {
     color: #222;
 }

incorporealcms/static/css/plain.css

@@ -0,0 +1,8 @@
+
+.img-25 {
+    max-width: 25% !important;
+}
+
+.img-50 {
+    max-width: 50% !important;
+}

incorporealcms/templates/404.html

@@ -11,7 +11,7 @@
     <h1>NOT FOUND</h1>
     <p>Sorry, <b><tt>{{ request.path }}</tt></b> does not seem to exist, at least not anymore.</p>
     <p>It's possible you followed a dead link on this site, in which case I would appreciate it if you could email me via:
-    bss @ &lt;this domain&gt; and I can take a look. I make an effort to symlink old content to its new location,
+    {{ config.CONTACT_EMAIL }} and I can take a look. I make an effort to symlink old content to its new location,
     so old links and URLs should, generally speaking, work.</p>
     <p>Otherwise, I suggest you go <a href="/">to the index</a> and navigate your way (hopefully) to what
     you're looking for.</p>

incorporealcms/templates/500.html

@@ -9,6 +9,6 @@
 {% block body %}
 <div class="content">
     <h1>INTERNAL SERVER ERROR</h1>
-    <p>Something bad happened! Please email me at bss @ &lt;this domain&gt; and tell me what happened.</p>
+    <p>Something bad happened! Please email me at {{ config.CONTACT_EMAIL }} and tell me what happened.</p>
 </div>
 {% endblock %}

incorporealcms/templates/base.html

@@ -7,9 +7,8 @@
 <meta property="og:url" content="{{ base_url }}">
 <meta name="twitter:card" content="summary_large_image">
 <meta name="viewport" content="width=device-width, initial-scale=1">
-<link rel="stylesheet" href="{{ url_for('static', filename='css/style.css') }}">
 <link rel="stylesheet" href="{{ url_for('static', filename=user_style) }}">
-<link rel="icon" href="{{ url_for('static', filename='img/favicon.png') }}">
+<link rel="icon" href="{% if config.FAVICON %}{{ config.FAVICON }}{% else %}{{ url_for('static', filename='img/favicon.png') }}{% endif %}">
 
 <div class="site-wrap">
     {% block header %}
@@ -23,6 +22,7 @@
         <div class="styles">
             <a href="?style=dark">[dark]</a>
             <a href="?style=light">[light]</a>
+            <a href="?style=plain">[plain]</a>
         </div>
     </div>
     {% endblock %}

tests/functional_tests.py

@@ -14,6 +14,8 @@ def test_page_that_doesnt_exist(client):
     response = client.get('/ohuesthaoeusth')
     assert response.status_code == 404
     assert b'<b><tt>/ohuesthaoeusth</tt></b> does not seem to exist' in response.data
+    # test the contact email config
+    assert b'bss@incorporeal.org' in response.data
 
 
 def test_files_outside_pages_do_not_get_served(client):
@@ -28,6 +30,8 @@ def test_internal_server_error_serves_error_page(client):
     response = client.get('/actually-a-png')
     assert response.status_code == 500
     assert b'INTERNAL SERVER ERROR' in response.data
+    # test the contact email config
+    assert b'bss@incorporeal.org' in response.data
 
 
 def test_weird_paths_do_not_get_served(client):

tests/test_factory.py

@@ -58,3 +58,13 @@ def test_media_file_access(client):
     response = client.get('/media/favicon.png')
     assert response.status_code == 200
     assert response.headers['content-type'] == 'image/png'
+
+
+def test_favicon_override():
+    """Test that a configuration with a specific favicon overrides the default."""
+    instance_path = os.path.join(HERE, 'instance')
+    app = create_app(instance_path=instance_path, test_config={'FAVICON': '/media/foo.png'})
+    client = app.test_client()
+    response = client.get('/no-title')
+    assert response.status_code == 200
+    assert b'<link rel="icon" href="/media/foo.png">' in response.data

tests/test_pages.py

@@ -3,7 +3,7 @@ import pytest
 from werkzeug.http import dump_cookie
 
 from incorporealcms.pages import (generate_parent_navs, instance_resource_path_to_request_path, render,
-                                  request_path_to_instance_resource_path)
+                                  request_path_to_breadcrumb_display, request_path_to_instance_resource_path)
 
 
 def test_generate_page_navs_index(app):
@@ -15,13 +15,13 @@ def test_generate_page_navs_index(app):
 def test_generate_page_navs_subdir_index(app):
     """Test that dir pages have navs to the root and themselves."""
     with app.app_context():
-        assert generate_parent_navs('pages/subdir/index.md') == [('incorporeal.org', '/'), ('/subdir/', '/subdir/')]
+        assert generate_parent_navs('pages/subdir/index.md') == [('incorporeal.org', '/'), ('subdir', '/subdir/')]
 
 
 def test_generate_page_navs_subdir_real_page(app):
     """Test that real pages have navs to the root, their parent, and themselves."""
     with app.app_context():
-        assert generate_parent_navs('pages/subdir/page.md') == [('incorporeal.org', '/'), ('/subdir/', '/subdir/'),
+        assert generate_parent_navs('pages/subdir/page.md') == [('incorporeal.org', '/'), ('subdir', '/subdir/'),
                                                                 ('Page', '/subdir/page')]
 
 
@@ -31,7 +31,7 @@ def test_generate_page_navs_subdir_with_title_parsing_real_page(app):
         assert generate_parent_navs('pages/subdir-with-title/page.md') == [
             ('incorporeal.org', '/'),
             ('SUB!', '/subdir-with-title/'),
-            ('/subdir-with-title/page', '/subdir-with-title/page')
+            ('page', '/subdir-with-title/page')
         ]
 
 
@@ -162,3 +162,12 @@ def test_request_resource_request_page(app):
     """Test that a request can resolve to a resource and back to a request."""
     with app.test_request_context():
         instance_resource_path_to_request_path(request_path_to_instance_resource_path('no-title')) == 'no-title'
+
+
+def test_request_path_to_breadcrumb_display_patterns():
+    """Test various conversions from request path to leaf nodes for display in the breadcrumbs."""
+    assert request_path_to_breadcrumb_display('/foo') == 'foo'
+    assert request_path_to_breadcrumb_display('/foo/') == 'foo'
+    assert request_path_to_breadcrumb_display('/foo/bar') == 'bar'
+    assert request_path_to_breadcrumb_display('/foo/bar/') == 'bar'
+    assert request_path_to_breadcrumb_display('/') == ''