Pelican theme for book

Question

Я пытаюсь преобразовать страницу на CMS в Pelican. Моя страница посвящена технической теме в виде книги (например, например, учебник/книга о HTML). Кажется, все статические генераторы сайтов сосредоточены на блогах. Поэтому большинство тем, которые я нашел, просто делают какой-то макет блога.

Может ли кто-нибудь указать мне тему, более подходящую для книги с разделами и разделами? В идеале, мне нравится видеть структуру контента в каком-то дереве на боковой панели. Кроме того, мне интересно, как связать определенные страницы, чтобы читатель мог перейти из раздела в раздел.

Answer 1

Я бы рекомендовал "Elegant" theme, он обладает гибкостью, которую вы ищете (на их домашней странице есть хороший пример бокового меню, о котором вы упоминаете).

Насколько вы структурируете свой сайт Пеликан, вы, вероятно, захотите полностью игнорировать функциональность блога Пеликан и создать свой книжный контент как кучу статических страниц. Если все ваши страницы уценка содержания, вы можете сделать что-то подобное в вашем пеликан каталога сайта:

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, и так далее и так далее. Теперь, когда вы посещаете свой сайт Пеликан, вы можете добавить «book_index /» в конец URL-адреса, и он автоматически переместит вас на вашу индексную страницу книги, которая, как вам удобно, все еще может быть записана в Markdown.