Есть ли способ встроить документ с описанием книги в качестве публикации в блоге?

Я создал учебник, используя Bookdown (который, на мой взгляд, является для него отличным форматом), и в настоящее время я создаю веб-сайт с использованием Blogdown (hugo-академическая тема). Я хотел бы иметь возможность добавить это руководство на страницу руководств в качестве публикации Bookdown, но я не знаю, возможно ли это.

Я новичок в Blogdown, поэтому мне не удалось найти никаких решений для этого. Если это невозможно, есть ли способ изменить ссылку на сообщение на гиперссылку, которая ведет пользователя к опубликованному файлу Bookdown (возможно, на bookdown.org)?


bookdown blogdown hugo
person arnold-c    schedule 08.08.2019    source источник
comment
Как насчет использования для этого проектов? Я считаю это более подходящим, чем сообщение (в блоге), и там легко разместить ссылку на внешний сайт. Возможно, удастся интегрировать визуализированный вывод из bookdown в blogdown, но это похоже на много хлопот.   -  person Ralf Stubner    schedule 08.08.2019
comment
@RalfStubner, похоже, он сделает то, что меня интересует, но когда я создал новую страницу виджета под названием Tutorials (я скопировал файлы проекта), он перенаправляет в каталог project / для связанных проектов. Что говорит ему искать там, если я ничего не видел в файлах конфигурации или индекса?   -  person arnold-c    schedule 08.08.2019
comment
У вас page_type = "project" в вашем tutorials.md? Вы должны изменить это на page_type = "tutorials".   -  person Ralf Stubner    schedule 08.08.2019
comment
Да, и он находится в каталоге content/tutorial/, так как я не хочу, чтобы он отображался на главном экране. Отображаются указанные фильтры, а не документы в content/tutorial/   -  person arnold-c    schedule 09.08.2019
comment
Чтобы использовать виджеты на страницах, отличных от домашней, вам необходимо добавить index.md страницу виджетов, c.f. sourcethemes.com/academic/docs/managing-content/ < / а>   -  person Ralf Stubner    schedule 09.08.2019
comment
Извините за неудобства, но у меня есть индексная страница, как предлагает документация.   -  person arnold-c    schedule 09.08.2019

Ответы (1)


arrow_upward
2
arrow_downward

С моей точки зрения, имеет смысл держать учебники (написанные с использованием bookdown) отдельно от остальной части веб-сайта (написанные с использованием blogdown). Одно из возможных решений - использовать виджет «портфолио» вместе с контентом, который использует external_link, аналогично тому, как работают «внешние проекты». Поскольку вам не нужен виджет учебных пособий на домашней странице, вам необходимо сделать следующее:

  1. Создайте каталог content/tutorial, содержащий каталоги для каждого отдельного учебника. Каждый из этих каталогов содержит index.md, смоделированный после "внешнего проекта", то есть с атрибутом external_link.

  2. Создайте второй каталог content/tutorials со страницей виджетов index.md, c.f. https://sourcethemes.com/academic/docs/managing-content/#create-a-widget-page

  3. Создайте во втором каталоге виджет портфолио, например путем копирования projects.md, где вы устанавливаете page_type на tutorial (имя первого каталога).

Решающий момент - вам нужно два каталога. Один для руководств и один для виджетов. Полный пример находится на GitHub. Конечно, имеет смысл добавить ссылку на /tutorials/ (не /tutorial/!) В меню ваших сайтов.

person Ralf Stubner    schedule 09.08.2019
comment
Это потрясающе! Спасибо за помощь, Ральф! - person arnold-c; 09.08.2019