'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
, будет использовать то, что наиболее подходит)?