书中的Pelican主题

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

然后(这是能够插入到书中各种内容的链接的关键)，通过使用save_as元标记指定文件book_index.md、chapter1.md等的输出位置。因此，例如，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网站时，您可以在URL的末尾添加" book _ index /“，它会自动将您带到您的图书索引页面--对您来说，该页面仍然可以用Markdown编写。