3 ms·
> Best tool to build a single page, text-focused static content site? Vim. Ok, seriously. You probably want Sphinx. Some very nice, mobile-friendly themes
by eric_bullington 9y ago
> Best tool to build a single page, text-focused static content site?
Vim.
Ok, seriously. You probably want Sphinx. Some very nice, mobile-friendly themes (I like Paramiko), and it can easily build a single page with table of contents automatically from a collection of rst or markdown pages. It's technically for documentation, but some people use it for their static web sites and blogs. Ideal for a text-driven site. I used it once to build a single-page documentation site, with table of contents (no longer online).
If you want a service that supports Sphinx, instead of deploying yourself on s3 or github, you can use readthedocs: https://readthedocs.org/ https://readthedocs.org/ For no ads, you can use their commercial service at https://readthedocs.com https://readthedocs.com
Mkdocs is another documentation generator like Sphinx with some attractive themes you could customize.
What kind of long-form content? Sounds interesting.
0. Sphinx: http://www.sphinx-doc.org/en/stable/ http://www.sphinx-doc.org/en/stable/
1. A few Sphinx themes: http://www.writethedocs.org/guide/tools/sphinx-themes/ http://www.writethedocs.org/guide/tools/sphinx-themes/
3. Here's a blog post (written with Sphinx) on using Sphinx as a static site generator: http://echorand.me/site/notes/articles/sphinx/static_html.html http://echorand.me/site/notes/articles/sphinx/static_html.ht...
- arikr 9y agoOh, great idea. Main thing missing for me in readthedocs is the mobile table of contents view feels somewhat unfriendly / poor usability. But I'll do some more mobile ToC usability research.