Docs on how to best create a custom `pkgdown` template?

Package development
#1

I am working on creating a custom pkgdown template for an organization.

I know of these two custom templates examples

I could not find, however, documentation on how to start from scratch. Does such material exist? In the meantime, I'll just draw inspiration from the two templates mentioned above. :slightly_smiling_face:

1 Like
#2

There isn't anything I know of, but, since they're built on top of bootstrap, I would think bootstrap theming guides would be a good place to start.
https://bootswatch.com/

1 Like
#3

Thanks!

Another aspect I think would need some docs is how to best simplify theme adoption within an organization/a company via maybe some custom usethis recipe :thinking: (use_pkgdown() doesn't have a template argument).

For future reference here's the template I've been working on https://github.com/ropenscilabs/rotemplate

#4

Sounds like a good feature request or PR! :smile:

1 Like
#5

I've opened an issue, we shall see :wink:

#6

Last question hidden in this thread I promise :pray: , I've seen the "basics of styling pkgdown" in https://enpiar.com/2017/12/18/integrating-pkgdown-with-your-personal-website/ <- these things aren't documented in pkgdown itself yet, right? E.g. having a pkgdown/extra.css file.

1 Like
#7

Not to my knowledge. I think it's just the material that's up on the pkgdown site right now:
https://pkgdown.r-lib.org/articles/pkgdown.html

1 Like
#8

Dear all:

I would like to share another pkgdown template I have created specifically for the rOpenSpain project.

I have used some of the hacks included in the rOpenSciLabs template, many thanks for that.

I hope it can be of any help in case someone is revisiting this thread looking for advice on how to create a template, like in my case.