Добавить логотип правообладателя или спонсора в pkgdown index.html

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

Я вижу, что на своих статических веб-страницах все пакеты tidyverse имеют логотип RStudio в конце списка разработчиков, например. https://dplyr.tidyverse.org/. Я просмотрел несколько файлов конфигурации yaml и просмотрел исходный код pkgdown, но, похоже, не смог отследить, где это указано, хотя я могу найти его в html-файлах, созданных pkgdown; и я могу сказать, что он загружается с этого URL-адреса https://www.tidyverse.org/rstudio-logo.svg;

Затем я попытался указать «Rstudio» в списке авторов моего пакета и увидел логотип! Так что это каким-то образом жестко закодировано в pkgdown, я полагаю, т.е. когда одним из авторов в описании является «RStudio», логотип извлекается из приведенного выше URL-адреса.

Как я могу добиться чего-то подобного с моим собственным логотипом, размещенным либо локально, либо в URL-адресе?


person Maria Kalimeri    schedule 08.03.2019    source источник


Ответы (1)


Хорошо, на самом деле я не «пролистал» (т.е. просмотрел) исходный код pkgdown эффективно. Действительно, логотип RStudio, а также ссылка на личную веб-страницу Хэдли Уикхема и Консорциума R находятся по умолчанию и могут быть найдены в build-home-authors.R. Это помогло мне понять, что имя записи yaml, которое я ищу, — это html. Мое решение ниже. Я добавляю дополнительный раздел «авторы» в _pkgdown.yml, чтобы перезаписать распечатку по умолчанию для спонсора (или любого другого разработчика в этом отношении).

authors:
   Funder’s Name:
     html: "<img src='man/figures/funderslogo.png' height='24' alt='LogoFnd’/> "
     href: https://fundersurl.com
person Maria Kalimeri    schedule 08.03.2019
comment
Еще одно замечание. Приведенные выше строки в файле .yml определяют относительный путь к корню источника пакета. index.html найдет логотип, потому что он создан из файла README.md (или альтернатив), найденного в корневом каталоге. Однако существует множество других файлов index.html, по одному для каждой вкладки веб-страницы, которым также нужен логотип для нижнего колонтитула. Они находятся внутри docs/ и не могут видеть относительный путь выше. Одно из решений, которое я использовал, состоит в том, чтобы заменить приведенную выше строку на img src='funderslogo.png и поместить копию png в docs/ и остальные его подкаталоги (не много, скорее всего, 3 или 4). - person Maria Kalimeri; 09.03.2019