书的鹈鹕主题

Question

我正在尝试将基于 CMS 的页面转换为 Pelican。我的页面是关于一本书形式的技术主题(例如关于 HTML 的教程/书籍)。似乎所有静态站点生成器都专注于博客。因此，我发现的大多数主题只是做某种博客布局。

任何人都可以请我指出一个更适合有章节和章节的书的主题吗？理想情况下，我喜欢在侧边栏中的某种树中看到内容结构。另外，我对如何链接某些页面感兴趣，以便读者可以从一个部分转到另一个部分。

Answer 1

我推荐 "Elegant" theme ，它具有您正在寻找的灵活性(他们的主页有您提到的侧边栏功能的一个很好的例子)。

至于如何构建 Pelican 站点，您可能希望完全忽略 Pelican 的博客功能，并将您的书籍内容创建为一堆静态页面。如果您的所有页面都是 Markdown 内容，您可以在 pelican 站点目录中执行以下操作:

pelicanconf.py
content/
    i_am_a_blog_post.md
    pages/
        book_index.md
        chapter1.md
        chapter2.md
        chapter3.md

然后(这是能够放入指向书中各种内容的链接的关键)您指定文件的输出位置 book_index.md , chapter1.md等，通过使用 save_as元标记。例如， book_index.md将包含:

Title: Book Index
save_as: book_index/index.html

Here is the index for my book:

* [Chapter 1]({{ SITEURL }}/chapter1/)
* [Chapter 2]({{ SITEURL }}/chapter2/)
* [Chapter 3]({{ SITEURL }}/chapter3/)

和 chapter1.md将包含 save_as: chapter1/index.html ， 等等等等。现在，当您访问 Pelican 站点时，您可以将“book_index/”添加到 URL 的末尾，它会自动将您带到您的图书索引页面 - 这对您来说仍然很方便，仍然可以用 Markdown 编写。