pelican - 书的鹈鹕主题

Question

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

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

Answer 1

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

至于如何构建 Pelican 站点，您可能希望完全忽略 Pelican 的博客功能，并将您的图书内容创建为一堆静态页面。如果您的所有页面都是降价内容，您可以在您的 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 网站时，您可以在 URL 的末尾添加“book_index/”，它会自动将您带到您的图书索引页面——这对您来说很方便，仍然可以用 Markdown 编写。