'pkgdown' для нескольких пакетов

Наша группа публикует R-пакеты (для внутреннего использования) в CRAN-подобном хранилище. Пользователи жаловались (справедливо), что документация не очень доступна для них без запуска R и выполнения ?function_name в интерактивном режиме.

Поэтому я хотел бы создать веб-сайт с документацией для всех версий пакетов R, созданных моей группой.

Если я сделаю pkgdown::build_site() в каталоге верхнего уровня моего пакета, который создает красивое автономное дерево docs/ содержащий HTML-файлы со всеми документами для этого пакета. У него даже есть выдающийся номер версии в верхней части каждой страницы, что приятно.

Теперь я хотел бы разместить это дерево документов на более крупном сайте, чтобы пользователь мог просматривать пакет, который он ищет, просматривать предыдущие версии и т. Д. Для этого кто-то создал решение?

Я думаю, что docs/ каталог может быть просто rsyncк веб-серверу, выстраивая путь из информации в DESCRIPTIONНапример:

Rscript -e 'pkgdown::build_site()'
mkdir -p r-docs/MyPackage        # Replace with real package name
mv docs r-docs/MyPackage/1.3.1   # Replace with real version
rsync -avz r-docs/ example.com:r-docs/

Но это становится немного неловко делать повторно - есть ли какая-то поддержка для этого варианта использования в pkgdown или другой подобный пакет (необязательно привязанный к pkgdown, будет использовать то, что наиболее подходит)?

0 ответов

Другие вопросы по тегам