diff --git a/docs/manual/ablog-quick-start.rst b/docs/manual/ablog-quick-start.rst index 128bb597..93c8b5e0 100644 --- a/docs/manual/ablog-quick-start.rst +++ b/docs/manual/ablog-quick-start.rst @@ -10,7 +10,8 @@ ABlog Quick Start :category: Manual :location: SF -This short walk through of blogging work flow assumes that you have already installed ABlog. If not, see :ref:`installation` guide. +This short walk through of blogging work flow assumes that you have already installed ABlog. +If not, see :ref:`installation` guide. *Note that this post is a working draft. Feel free to revise it on GitHub.* @@ -29,6 +30,8 @@ This command will ask you a few questions and create the following files: * :file:`about.rst`, another non-post page example. +ABlog uses Alabaster_ theme by default. + Build and View -------------- @@ -93,7 +96,7 @@ See :ref:`disqus-integration` for configuration options. Analytics --------- -ABlog uses Alabaster_ theme by default. You can use theme options to set your `Google Analytics`__ identifier to enable tracking. +You can use theme options to set your `Google Analytics`__ identifier to enable tracking. __ https://www.google.com/analytics/ diff --git a/src/ablog/post.py b/src/ablog/post.py index 7c077e6d..2d5b8527 100644 --- a/src/ablog/post.py +++ b/src/ablog/post.py @@ -492,7 +492,11 @@ def process_postlist(app, doctree, docname): if item.options.get("external_link"): ref["refuri"] = post.options.get("external_link") else: - ref["refuri"] = app.builder.get_relative_uri(docname, item.docname) + refuri = app.builder.get_relative_uri(docname, item.docname) + # TODO: Work out why this is needed sometimes + if not refuri.endswith("index.html"): + refuri = refuri + "index.html" + ref["refuri"] = refuri ref["internal"] = True ref["ids"] = [] ref["backrefs"] = [] diff --git a/tox.ini b/tox.ini index 144f5aa9..1e20d80d 100644 --- a/tox.ini +++ b/tox.ini @@ -1,6 +1,6 @@ [tox] envlist = - py{39,310,311}{-sphinx5,-sphinx6,-sphinx7,-sphinxdev,-docs,-linkcheck} + py{39,310,311}{-sphinx5,-sphinx6,-sphinx7,-sphinx8,-sphinxdev,-docs,-linkcheck} isolated_build = true [testenv] @@ -17,8 +17,8 @@ commands = sphinx5: pip install -U "sphinx>=5.0,<6.0" sphinx6: pip install -U "sphinx>=6.0,<7.0" sphinx7: pip install -U "sphinx>=7.0,<8.0" - # TODO: Figure this out on azure - # sphinxdev: pip install -U "git+https://repo.or.cz/docutils.git#egg=docutils&subdirectory=docutils" + sphinx8: pip install -U "sphinx>=8.0,<9.0" + sphinxdev: pip install -U "git+https://repo.or.cz/docutils.git#egg=docutils&subdirectory=docutils" sphinxdev: pip install -U "git+https://github.com/sphinx-doc/sphinx" pip freeze --all --no-input pytest -vvv -r a --pyargs ablog