书的鹈鹕主题

Question

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

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

Answer 1

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

就您如何构建 Pelican 网站而言，您可能希望完全忽略 Pelican 的博客功能，并将您的图书内容创建为一堆静态页面。如果您的所有页面都是降价内容，您可以在您的 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 编写。