38 Commits

Author SHA1 Message Date
b6aa125b8d add sane_lists to markdown extensions
this fixes stuff like

* foo
* bar

1. hax
2021-02-13 11:07:00 -06:00
15142054da tweak the appearance of footnotes 2021-02-12 19:37:25 -06:00
dc81ef35de float image left/right for inlining in an article 2021-02-12 12:51:43 -06:00
c292f33334 CSS for framing an image inline the article 2021-02-12 12:51:12 -06:00
1c052b8409 pin bandit in requirements-dev since 1.7.0 is weird in tox 2021-02-12 09:28:12 -06:00
7cf8a427ce add an .img-25 for 25% wide images 2021-02-12 09:26:10 -06:00
e8a749d9ba Revert "tweak the base text line height, again"
This reverts commit 1878d5951b.

the more I look at this, the more I like the old text spacing
2021-02-12 09:21:21 -06:00
ae72fe87b5 class to center an image as a block element
this is effectively a replacement for div.splash means of getting a
centered header image, and can be used anywhere
2021-02-12 09:19:35 -06:00
bb0e71e9e4 give *all* images max-width of the inner column
this was done for the giant splash logo but I should really just
restrain this everywhere
2021-02-12 09:18:54 -06:00
3bfdacdb6d add attr_list to markdown extensions
this will lead to me putting less HTML in the .md files, which is a good
thing
2021-02-12 09:15:41 -06:00
e6d2015de5 use smarty markdown extension for dashes, ellipses 2021-02-11 19:05:01 -06:00
56eb767e33 don't let sub/superscripts affect line height 2021-02-11 18:53:57 -06:00
07031fe667 enable footnotes extra for markdown 2021-02-11 18:36:48 -06:00
48c6e8495a provide some styling of footnotes 2021-02-11 18:20:42 -06:00
4f45943775 initialize markdown on a per-page basis
the footnote extra expects to only parse one document over the Markup's
lifetime, and writes the footnotes to the bottom of every page that is
rendered (again assuming only one) with links back to the reference

having one parser for the entire app, naturally, introduced
ever-increasing footnote links and every footnote on the site showing up
on every page. this was not intended

in some light testing, doing this per-request has a nominal effect on
performance
2021-02-11 18:17:26 -06:00
b26ea6a661 add html tag in order to specify lang="en" 2021-02-11 09:36:24 -06:00
1878d5951b tweak the base text line height, again 2021-02-11 09:35:21 -06:00
829165ad8c style link underline same color as the hover 2021-02-11 09:35:21 -06:00
7d982b96c9 tweak text colors; less normal, more bold 2021-02-11 09:35:21 -06:00
5e41cde52e use a flexbox for the header sections
this is better than a float because I have always kind of hated how
floating divs work, and this also orders and displays the navs better in
elinks
2021-02-11 00:23:19 -06:00
ad33cf2e83 replace section tags with div tags
syntactically incorrect usage, as picked up by a W3C validator
2021-02-11 00:08:19 -06:00
87ad48d8d2 add mdx-linkify to markdown extensions 2021-01-22 09:51:53 -06:00
8a6f4d6b45 test multi-line metadata entries 2021-01-17 23:58:57 -06:00
c25fefa9e3 add opengraph metadata to pages, via Markdown meta 2021-01-17 23:02:14 -06:00
b0795999fe make splash images look better on small devices 2020-12-14 16:26:08 -06:00
aaced9d0e1 add polycephaly-style figure support
this is really pushing my patience for CSS, but I've always thought this
looked nice, so I'm going to try to retain it
2020-12-14 16:25:35 -06:00
4042932240 tone down the line-height a bit
I think the color changes and using viewport magic has helped
readability a bit
2020-12-08 18:56:49 -06:00
49ab2befb6 disable browser resize magic, do viewport magic instead 2020-12-08 18:47:02 -06:00
fbf6a81e0b use my old "square" logo as favicon
also provide a backgroundless version as a possible splash page image
2020-12-08 18:46:04 -06:00
dabf9f7544 more corrections of the link colors 2020-12-08 18:27:55 -06:00
dcf173ab61 add a test to ensure style selection works 2020-12-08 17:12:35 -06:00
d2c1c2e3ce why did I make user styles a config setting???
this moves it into the code, where it's sensible, and leaves the default
to the config
2020-12-08 16:43:20 -06:00
3fcf916317 requirements bump 2020-12-08 16:33:19 -06:00
67e1890629 increase the line height for readability(?) 2020-12-07 21:55:56 -06:00
e1cb541ea5 highlight links in light theme as in dark theme 2020-12-07 21:55:32 -06:00
93e9c8dc24 tweaks to the dark theme 2020-12-07 21:54:43 -06:00
7cf11986c5 user-selectable light and dark themes
cookies, template rendering with different CSS files via default or
request param or cookie, etc.
2020-10-30 00:19:19 -05:00
5ca483a904 configurable markdown extensions
meta is always loaded, because the code expects it
2020-10-29 23:51:58 -05:00
18 changed files with 641 additions and 118 deletions

View File

@@ -32,5 +32,23 @@ class Config(object):
}, },
} }
MARKDOWN_EXTENSIONS = ['extra', 'mdx_linkify', 'sane_lists', 'smarty', 'tables']
MARKDOWN_EXTENSION_CONFIGS = {
'extra': {
'attr_list': {},
'footnotes': {
'UNIQUE_IDS': True,
},
},
'smarty': {
'smart_dashes': True,
'smart_quotes': False,
'smart_angled_quotes': False,
'smart_ellipses': True,
},
}
DEFAULT_PAGE_STYLE = 'light'
TITLE_SUFFIX = 'incorporeal.org' TITLE_SUFFIX = 'incorporeal.org'
MEDIA_DIR = 'media' MEDIA_DIR = 'media'

21
incorporealcms/lib.py Normal file
View File

@@ -0,0 +1,21 @@
"""Miscellaneous helper functions and whatnot."""
import markdown
from flask import current_app as app
def get_meta_str(md, key):
"""Provide the page's (parsed in Markup obj md) metadata for the specified key, or '' if unset."""
return " ".join(md.Meta.get(key)) if md.Meta.get(key) else ""
def init_md():
"""Initialize the Markdown parser.
This used to done at the app level in __init__, but extensions like footnotes apparently
assume the parser to only live for the length of parsing one document, and create double
footnote ref links if the one parser sees the same document multiple times.
"""
# initialize markdown parser from config, but include
# extensions our app depends on, like the meta extension
return markdown.Markdown(extensions=app.config['MARKDOWN_EXTENSIONS'] + ['meta'],
extension_configs=app.config['MARKDOWN_EXTENSION_CONFIGS'])

View File

@@ -3,16 +3,16 @@ import datetime
import logging import logging
import os import os
import markdown
from flask import Blueprint, Markup, abort from flask import Blueprint, Markup, abort
from flask import current_app as app from flask import current_app as app
from flask import redirect, render_template from flask import make_response, redirect, render_template, request
from tzlocal import get_localzone from tzlocal import get_localzone
from incorporealcms.lib import get_meta_str, init_md
logger = logging.getLogger(__name__) logger = logging.getLogger(__name__)
bp = Blueprint('pages', __name__, url_prefix='/') bp = Blueprint('pages', __name__, url_prefix='/')
md = markdown.Markdown(extensions=['meta', 'tables'])
@bp.route('/', defaults={'path': 'index'}) @bp.route('/', defaults={'path': 'index'})
@@ -34,13 +34,39 @@ def display_page(path):
logger.warning("requested path '%s' (resolved path '%s') not found!", path, resolved_path) logger.warning("requested path '%s' (resolved path '%s') not found!", path, resolved_path)
abort(404) abort(404)
else: else:
md = init_md()
content = Markup(md.convert(entry)) content = Markup(md.convert(entry))
logger.debug("file metadata: %s", md.Meta) logger.debug("file metadata: %s", md.Meta)
title = " ".join(md.Meta.get('title')) if md.Meta.get('title') else ""
return render_template('base.html', title=title, content=content, navs=parent_navs, return render('base.html', title=get_meta_str(md, 'title'), description=get_meta_str(md, 'description'),
image=get_meta_str(md, 'image'), base_url=request.base_url, content=content, navs=parent_navs,
mtime=mtime.strftime('%Y-%m-%d %H:%M:%S %Z')) mtime=mtime.strftime('%Y-%m-%d %H:%M:%S %Z'))
def render(template_name_or_list, **context):
"""Wrap Flask's render_template.
* Determine the proper site theme to use in the template and provide it.
"""
PAGE_STYLES = {
'dark': 'css/dark.css',
'light': 'css/light.css',
}
selected_style = request.args.get('style', None)
if selected_style:
user_style = selected_style
else:
user_style = request.cookies.get('user-style')
logger.debug("user style cookie: %s", user_style)
context['user_style'] = PAGE_STYLES.get(user_style, PAGE_STYLES.get(app.config['DEFAULT_PAGE_STYLE']))
resp = make_response(render_template(template_name_or_list, **context))
if selected_style:
resp.set_cookie('user-style', selected_style)
return resp
def resolve_page_file(path): def resolve_page_file(path):
"""Manipulate the request path to find appropriate page file. """Manipulate the request path to find appropriate page file.
@@ -86,6 +112,8 @@ def generate_parent_navs(path):
else: else:
with app.open_instance_resource(resolved_path, 'r') as entry_file: with app.open_instance_resource(resolved_path, 'r') as entry_file:
entry = entry_file.read() entry = entry_file.read()
# for issues regarding parser reuse (see lib.init_md) we reinitialize the parser here
md = init_md()
_ = Markup(md.convert(entry)) _ = Markup(md.convert(entry))
page_name = " ".join(md.Meta.get('title')) if md.Meta.get('title') else f'/{path}' page_name = " ".join(md.Meta.get('title')) if md.Meta.get('title') else f'/{path}'
return generate_parent_navs(parent_path) + [(page_name, f'/{path}')] return generate_parent_navs(parent_path) + [(page_name, f'/{path}')]

View File

@@ -0,0 +1,73 @@
html {
color: #CCC;
}
body {
background: black;
}
strong {
color: #EEE;
}
.site-wrap {
background: #111;
border: 1px solid #222;
border-top: none;
border-bottom: none;
}
h1, h2, h3, h4, h5, h6 {
color: #B31D15;
}
a:link, a:visited {
color: #EEE;
border-bottom: 1px dotted #EEE;
}
a:hover, a:active {
color: #B31D15;
border-bottom: 1px dotted #B31D15;
}
div.header {
background: #222;
border-bottom: 1px solid #222;
}
div.nav, div.styles {
color: #BBB;
}
div.nav a, div.styles a {
color: #BBB;
}
table, th, td {
border: 1px solid #333;
}
th {
background: #333;
}
blockquote {
background-color: rgba(120, 120, 120, 0.3);
border: 1px solid #222;
}
.img-frame {
background-color: rgba(255, 255, 255, 0.1);
border: 1px solid #333;
}
figure {
background: #222;
border: 1px solid #333;
}
figcaption {
color: #BBB;
}

View File

@@ -0,0 +1,73 @@
html {
color: #222;
}
body {
background: #999;
}
strong {
color: #111;
}
.site-wrap {
background: white;
border: 1px solid #ddd;
border-top: none;
border-bottom: none;
}
h1, h2, h3, h4, h5, h6 {
color: #811610;
}
a:link, a:visited {
color: #111;
border-bottom: 1px dotted #111;
}
a:hover, a:active {
color: #811610;
border-bottom: 1px dotted #811610;
}
div.header {
background: #EEE;
border-bottom: 1px solid #CCC;
}
div.nav, div.styles {
color: #666;
}
div.nav a, div.styles a {
color: #666;
}
table, th, td {
border: 1px solid #ccc;
}
th {
background: #eee;
}
blockquote {
background-color: rgba(120, 120, 120, 0.1);
border: 1px solid #CCC;
}
.img-frame {
background-color: rgba(0, 0, 0, 0.1);
border: 1px solid #BBB;
}
figure {
background: #EFEFEF;
border: 1px solid #CCCCCC;
}
figcaption {
color: #777777;
}

View File

@@ -1,31 +1,22 @@
html { html {
font-family: sans-serif; font-family: sans-serif;
padding: 0; padding: 0;
color: #222;
} }
body { body {
background: #888;
margin: 0; margin: 0;
text-size-adjust: 100%;
-ms-text-size-adjust: 100%;
-moz-text-size-adjust: 100%;
-webkit-text-size-adjust: 100%;
} }
.site-wrap { .site-wrap {
background: white;
max-width: 70pc; max-width: 70pc;
min-height: 100vh; min-height: 100vh;
margin: 0; margin: 0;
margin-left: auto; margin-left: auto;
margin-right: auto; margin-right: auto;
border: 1px solid #ddd;
border-top: none;
border-bottom: none;
}
h1,h2,h3,h4,h5,h6 {
color: #811610;
} }
h1 { h1 {
@@ -53,53 +44,55 @@ h6 {
} }
a:link { a:link {
color: #222;
font-weight: bold; font-weight: bold;
text-decoration: none; text-decoration: none;
border-bottom: 1px dotted #222;
} }
a:visited { a:visited {
color: #222;
font-weight: bold; font-weight: bold;
text-decoration: none; text-decoration: none;
border-bottom: 1px dotted #222;
} }
a:hover { a:hover {
color: #811610;
font-weight: bold; font-weight: bold;
text-decoration: none; text-decoration: none;
border-bottom: 1px dotted #222;
} }
a:active { a:active {
color: #811610;
font-weight: bold; font-weight: bold;
text-decoration: none; text-decoration: none;
border-bottom: 1px dotted #222;
} }
section.nav { div.header {
color: #666; display: flex;
background: #eee; justify-content: space-between;
}
div.nav, div.styles {
font-size: 0.75em; font-size: 0.75em;
border-bottom: 1px solid #ccc;
padding: 0.25em 0.5em; padding: 0.25em 0.5em;
} }
section.nav a { div.nav a, div.styles a {
color: #666;
border-bottom: none; border-bottom: none;
} }
section.content { div.content {
font-size: 11pt; font-size: 11pt;
padding: 0 1em; padding: 0 1em;
line-height: 1.5em; line-height: 1.5em;
} }
sup, sub {
vertical-align: baseline;
position: relative;
top: -0.4em;
}
sub {
top: 0.4em;
}
footer { footer {
display: block; display: block;
font-size: 75%; font-size: 75%;
@@ -119,11 +112,110 @@ table, th, td {
margin-bottom: 15px; margin-bottom: 15px;
} }
th {
background: #eee;
}
blockquote { blockquote {
background-color: rgba(120, 120, 120, 0.1); background-color: rgba(120, 120, 120, 0.3);
padding: 1px 10px; padding: 1px 10px;
} }
.splash {
margin-top: 1em;
margin-bottom: 1em;
text-align: center;
}
img {
max-width: 100%;
}
.img-25 {
max-width: 25% !important;
}
.img-50 {
max-width: 50% !important;
}
.img-center {
display: block;
margin-left: auto;
margin-right: auto;
}
.img-left {
float: left;
margin-right: 1em;
}
.img-right {
float: right;
margin-left: 1em;
}
.img-frame {
padding: 5px;
}
/* For screens with width smaller than 400px */
.figure-left .figure-right {
max-width: 95%;
float: none;
margin-left: 10px;
margin-right: 10px;
}
/* For larger screens */
@media only screen and (min-width: 400px) {
.figure-left {
float: left;
margin-top: 0;
margin-left: 0;
}
.figure-right {
float: right;
margin-top: 0;
margin-right: 0;
}
}
figure {
max-width: 400px;
padding: 5px;
margin: 10px;
margin-top: 0;
margin-bottom: 5px;
}
figure img {
max-width: 100%;
height: auto;
}
figcaption {
font-family: "Times New Roman", serif;
color: #777777;
text-align: center;
font-style: italic;
line-height: 1.3em;
margin-top: 5px;
}
.thumbnail-image {
width: 150px;
height: auto;
margin: 5px;
display: inline;
}
.footnote {
font-size: 0.8em;
}
.footnote p {
margin: 0;
}
.footnote-ref:link, .footnote-ref:visited, .footnote-ref:hover, .footnote-ref:active {
border-bottom: none;
font-weight: normal;
}

Binary file not shown.

After

Width:  |  Height:  |  Size: 49 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 28 KiB

After

Width:  |  Height:  |  Size: 49 KiB

View File

@@ -1,18 +1,34 @@
<!doctype html> <!doctype html>
<html lang="en">
<title>{{ title }}{% if title %} - {% endif %}{{ config.TITLE_SUFFIX }}</title> <title>{{ title }}{% if title %} - {% endif %}{{ config.TITLE_SUFFIX }}</title>
{% if title %}<meta property="og:title" content="{{ title }}">{% endif %}
{% if description %}<meta property="og:description" content="{{ description }}">{% endif %}
{% if image %}<meta property="og:image" content="{{ image }}">{% endif %}
<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='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="{{ url_for('static', filename='img/favicon.png') }}">
<section class="site-wrap">
<section class="nav"> <div class="site-wrap">
<div class="header">
<div class="nav">
{% for nav in navs %} {% for nav in navs %}
<a href="{{ nav.1 }}">{{ nav.0 }}</a> <a href="{{ nav.1 }}">{{ nav.0 }}</a>
{% if not loop.last %} &raquo; {% endif %} {% if not loop.last %} &raquo; {% endif %}
{% endfor %} {% endfor %}
</section> </div>
<section class="content"> <div class="styles">
<a href="?style=dark">[dark]</a>
<a href="?style=light">[light]</a>
</div>
</div>
<div class="content">
{{ content }} {{ content }}
</section> </div>
<footer> <footer>
<i>Last modified: {{ mtime }}</i> <i>Last modified: {{ mtime }}</i>
</footer> </footer>
</section> </div>
</html>

View File

@@ -5,7 +5,7 @@ pytest
pytest-cov pytest-cov
# linting and other static code analysis # linting and other static code analysis
bandit bandit==1.6.2 # pinned because 1.7.0 wasn't running right in tox
dlint dlint
flake8 flake8
flake8-blind-except flake8-blind-except

View File

@@ -4,61 +4,148 @@
# #
# pip-compile --output-file=requirements/requirements-dev.txt requirements/requirements-dev.in # pip-compile --output-file=requirements/requirements-dev.txt requirements/requirements-dev.in
# #
appdirs==1.4.4 # via virtualenv appdirs==1.4.4
attrs==20.2.0 # via pytest # via virtualenv
bandit==1.6.2 # via -r requirements/requirements-dev.in attrs==20.3.0
click==7.1.2 # via flask, pip-tools # via pytest
coverage==5.3 # via pytest-cov bandit==1.6.2
distlib==0.3.1 # via virtualenv # via -r requirements/requirements-dev.in
dlint==0.10.3 # via -r requirements/requirements-dev.in bleach==3.2.2
filelock==3.0.12 # via tox, virtualenv # via mdx-linkify
flake8-blind-except==0.1.1 # via -r requirements/requirements-dev.in click==7.1.2
flake8-builtins==1.5.3 # via -r requirements/requirements-dev.in # via
flake8-docstrings==1.5.0 # via -r requirements/requirements-dev.in # flask
flake8-executable==2.0.4 # via -r requirements/requirements-dev.in # pip-tools
flake8-fixme==1.1.1 # via -r requirements/requirements-dev.in coverage==5.3.1
flake8-isort==4.0.0 # via -r requirements/requirements-dev.in # via pytest-cov
flake8-logging-format==0.6.0 # via -r requirements/requirements-dev.in distlib==0.3.1
flake8-mutable==1.2.0 # via -r requirements/requirements-dev.in # via virtualenv
flake8==3.8.4 # via -r requirements/requirements-dev.in, dlint, flake8-builtins, flake8-docstrings, flake8-executable, flake8-isort, flake8-mutable dlint==0.11.0
flask==1.1.2 # via -r requirements/requirements.in # via -r requirements/requirements-dev.in
gitdb==4.0.5 # via gitpython filelock==3.0.12
gitpython==3.1.9 # via bandit # via
importlib-metadata==2.0.0 # via flake8, markdown, pluggy, pytest, stevedore, tox, virtualenv # tox
iniconfig==1.1.1 # via pytest # virtualenv
isort==5.6.4 # via flake8-isort flake8-blind-except==0.2.0
itsdangerous==1.1.0 # via flask # via -r requirements/requirements-dev.in
jinja2==2.11.2 # via flask flake8-builtins==1.5.3
markdown==3.3.2 # via -r requirements/requirements.in # via -r requirements/requirements-dev.in
markupsafe==1.1.1 # via jinja2 flake8-docstrings==1.5.0
mccabe==0.6.1 # via flake8 # via -r requirements/requirements-dev.in
packaging==20.4 # via pytest, tox flake8-executable==2.1.1
pbr==5.5.1 # via stevedore # via -r requirements/requirements-dev.in
pip-tools==5.3.1 # via -r requirements/requirements-dev.in flake8-fixme==1.1.1
pluggy==0.13.1 # via pytest, tox # via -r requirements/requirements-dev.in
py==1.9.0 # via pytest, tox flake8-isort==4.0.0
pycodestyle==2.6.0 # via flake8 # via -r requirements/requirements-dev.in
pydocstyle==5.1.1 # via flake8-docstrings flake8-logging-format==0.6.0
pyflakes==2.2.0 # via flake8 # via -r requirements/requirements-dev.in
pyparsing==2.4.7 # via packaging flake8-mutable==1.2.0
pytest-cov==2.10.1 # via -r requirements/requirements-dev.in # via -r requirements/requirements-dev.in
pytest==6.1.1 # via -r requirements/requirements-dev.in, pytest-cov flake8==3.8.4
pytz==2020.1 # via tzlocal # via
pyyaml==5.3.1 # via bandit # -r requirements/requirements-dev.in
six==1.15.0 # via bandit, packaging, pip-tools, tox, virtualenv # dlint
smmap==3.0.4 # via gitdb # flake8-builtins
snowballstemmer==2.0.0 # via pydocstyle # flake8-docstrings
stevedore==3.2.2 # via bandit # flake8-executable
testfixtures==6.15.0 # via flake8-isort # flake8-isort
toml==0.10.1 # via pytest, tox # flake8-mutable
tox-wheel==0.5.0 # via -r requirements/requirements-dev.in flask==1.1.2
tox==3.20.1 # via -r requirements/requirements-dev.in, tox-wheel # via -r requirements/requirements.in
tzlocal==2.1 # via -r requirements/requirements.in gitdb==4.0.5
versioneer==0.18 # via -r requirements/requirements-dev.in # via gitpython
virtualenv==20.0.35 # via tox gitpython==3.1.12
werkzeug==1.0.1 # via flask # via bandit
wheel==0.35.1 # via tox-wheel iniconfig==1.1.1
zipp==3.3.1 # via importlib-metadata # via pytest
isort==5.7.0
# via flake8-isort
itsdangerous==1.1.0
# via flask
jinja2==2.11.2
# via flask
markdown==3.3.3
# via
# -r requirements/requirements.in
# mdx-linkify
markupsafe==1.1.1
# via jinja2
mccabe==0.6.1
# via flake8
mdx-linkify==2.1
# via -r requirements/requirements.in
packaging==20.8
# via
# bleach
# pytest
# tox
pbr==5.5.1
# via stevedore
pip-tools==5.5.0
# via -r requirements/requirements-dev.in
pluggy==0.13.1
# via
# pytest
# tox
py==1.10.0
# via
# pytest
# tox
pycodestyle==2.6.0
# via flake8
pydocstyle==5.1.1
# via flake8-docstrings
pyflakes==2.2.0
# via flake8
pyparsing==2.4.7
# via packaging
pytest-cov==2.11.1
# via -r requirements/requirements-dev.in
pytest==6.2.1
# via
# -r requirements/requirements-dev.in
# pytest-cov
pytz==2020.5
# via tzlocal
pyyaml==5.4.1
# via bandit
six==1.15.0
# via
# bandit
# bleach
# tox
# virtualenv
smmap==3.0.4
# via gitdb
snowballstemmer==2.1.0
# via pydocstyle
stevedore==3.3.0
# via bandit
testfixtures==6.17.1
# via flake8-isort
toml==0.10.2
# via
# pytest
# tox
tox-wheel==0.6.0
# via -r requirements/requirements-dev.in
tox==3.21.2
# via
# -r requirements/requirements-dev.in
# tox-wheel
tzlocal==2.1
# via -r requirements/requirements.in
versioneer==0.19
# via -r requirements/requirements-dev.in
virtualenv==20.4.0
# via tox
webencodings==0.5.1
# via bleach
werkzeug==1.0.1
# via flask
wheel==0.36.2
# via tox-wheel
# The following packages are considered to be unsafe in a requirements file: # The following packages are considered to be unsafe in a requirements file:
# pip # pip

View File

@@ -1,3 +1,4 @@
Flask # general purpose web service and web server stuff Flask # general purpose web service and web server stuff
Markdown # markdown rendering in templates Markdown # markdown rendering in templates
mdx-linkify # convert URLs in the text to clickable links
tzlocal # identifying system's local timezone tzlocal # identifying system's local timezone

View File

@@ -4,14 +4,35 @@
# #
# pip-compile --output-file=requirements/requirements.txt requirements/requirements.in # pip-compile --output-file=requirements/requirements.txt requirements/requirements.in
# #
click==7.1.2 # via flask bleach==3.2.2
flask==1.1.2 # via -r requirements/requirements.in # via mdx-linkify
importlib-metadata==2.0.0 # via markdown click==7.1.2
itsdangerous==1.1.0 # via flask # via flask
jinja2==2.11.2 # via flask flask==1.1.2
markdown==3.3.2 # via -r requirements/requirements.in # via -r requirements/requirements.in
markupsafe==1.1.1 # via jinja2 itsdangerous==1.1.0
pytz==2020.1 # via tzlocal # via flask
tzlocal==2.1 # via -r requirements/requirements.in jinja2==2.11.2
werkzeug==1.0.1 # via flask # via flask
zipp==3.3.1 # via importlib-metadata markdown==3.3.3
# via
# -r requirements/requirements.in
# mdx-linkify
markupsafe==1.1.1
# via jinja2
mdx-linkify==2.1
# via -r requirements/requirements.in
packaging==20.8
# via bleach
pyparsing==2.4.7
# via packaging
pytz==2020.5
# via tzlocal
six==1.15.0
# via bleach
tzlocal==2.1
# via -r requirements/requirements.in
webencodings==0.5.1
# via bleach
werkzeug==1.0.1
# via flask

View File

@@ -30,6 +30,15 @@ def test_page_without_title_metadata(client):
assert b'<h1>this page doesn\'t have a title!</h1>' in response.data assert b'<h1>this page doesn\'t have a title!</h1>' in response.data
def test_page_with_card_metadata(client):
"""Test that a page with opengraph metadata."""
response = client.get('/more-metadata')
assert response.status_code == 200
assert b'<meta property="og:title" content="title for the page">' in response.data
assert b'<meta property="og:description" content="description of this page made even longer">' in response.data
assert b'<meta property="og:image" content="http://buh.com/test.img">' in response.data
def test_page_has_modified_timestamp(client): def test_page_has_modified_timestamp(client):
"""Test that pages have modified timestamps in them.""" """Test that pages have modified timestamps in them."""
response = client.get('/') response = client.get('/')
@@ -52,3 +61,24 @@ def test_that_dir_request_does_not_redirect(client):
response = client.get('/subdir/') response = client.get('/subdir/')
assert response.status_code == 200 assert response.status_code == 200
assert b'another page' in response.data assert b'another page' in response.data
def test_setting_selected_style_includes_cookie(client):
"""Test that a request with style=foo sets the cookie and renders appropriately."""
response = client.get('/')
style_cookie = next((cookie for cookie in client.cookie_jar if cookie.name == 'user-style'), None)
assert style_cookie is None
response = client.get('/?style=light')
style_cookie = next((cookie for cookie in client.cookie_jar if cookie.name == 'user-style'), None)
assert response.status_code == 200
assert b'light.css' in response.data
assert b'dark.css' not in response.data
assert style_cookie.value == 'light'
response = client.get('/?style=dark')
style_cookie = next((cookie for cookie in client.cookie_jar if cookie.name == 'user-style'), None)
assert response.status_code == 200
assert b'dark.css' in response.data
assert b'light.css' not in response.data
assert style_cookie.value == 'dark'

View File

@@ -0,0 +1,3 @@
Test page
word --- word

View File

@@ -0,0 +1,6 @@
Title: title for the page
Description: description of this page
made even longer
Image: http://buh.com/test.img
hello

View File

@@ -13,6 +13,36 @@ def test_config():
assert create_app(instance_path=instance_path, test_config={"TESTING": True}).testing assert create_app(instance_path=instance_path, test_config={"TESTING": True}).testing
def test_markdown_meta_extension_always():
"""Test that the markdown meta extension is always loaded, even if not specified."""
app = create_app(instance_path=os.path.join(HERE, 'instance'),
test_config={'MARKDOWN_EXTENSIONS': []})
client = app.test_client()
response = client.get('/')
assert response.status_code == 200
assert b'<title>Index - incorporeal.org</title>' in response.data
def test_custom_markdown_extensions_work():
"""Test we can change extensions via config, and that they work.
This used to test smarty, but that's added by default now, so we test
that it can be removed by overriding the option.
"""
app = create_app(instance_path=os.path.join(HERE, 'instance'))
client = app.test_client()
response = client.get('/mdash-or-triple-dash')
assert response.status_code == 200
assert b'word &mdash; word' in response.data
app = create_app(instance_path=os.path.join(HERE, 'instance'),
test_config={'MARKDOWN_EXTENSIONS': []})
client = app.test_client()
response = client.get('/mdash-or-triple-dash')
assert response.status_code == 200
assert b'word --- word' in response.data
def test_title_override(): def test_title_override():
"""Test that a configuration with a specific title overrides the default.""" """Test that a configuration with a specific title overrides the default."""
instance_path = os.path.join(HERE, 'instance') instance_path = os.path.join(HERE, 'instance')

View File

@@ -1,5 +1,7 @@
"""Unit test helper methods.""" """Unit test helper methods."""
from incorporealcms.pages import generate_parent_navs, is_file_path_actually_dir_path, resolve_page_file from werkzeug.http import dump_cookie
from incorporealcms.pages import generate_parent_navs, is_file_path_actually_dir_path, render, resolve_page_file
def test_resolve_page_file_dir_to_index(): def test_resolve_page_file_dir_to_index():
@@ -74,3 +76,25 @@ def test_is_file_path_actually_dir_path_nonsense_dir_is_no(app):
"""Test that a directory request is a directory request even if the dir doesn't exist.""" """Test that a directory request is a directory request even if the dir doesn't exist."""
with app.app_context(): with app.app_context():
assert not is_file_path_actually_dir_path('/antphnathpnthapnthsnthax/') assert not is_file_path_actually_dir_path('/antphnathpnthapnthsnthax/')
def test_render_with_user_dark_theme(app):
"""Test that a request with the dark theme selected renders the dark theme."""
cookie = dump_cookie("user-style", 'dark')
with app.test_request_context(headers={'COOKIE': cookie}):
assert b'dark.css' in render('base.html').data
assert b'light.css' not in render('base.html').data
def test_render_with_user_light_theme(app):
"""Test that a request with the light theme selected renders the light theme."""
with app.test_request_context():
assert b'light.css' in render('base.html').data
assert b'dark.css' not in render('base.html').data
def test_render_with_no_user_theme(app):
"""Test that a request with no theme set renders the light theme."""
with app.test_request_context():
assert b'light.css' in render('base.html').data
assert b'dark.css' not in render('base.html').data