mgeier / insipid-sphinx-theme

:yawning_face: An insipid theme for the Sphinx documentation generator.
https://insipid-sphinx-theme.readthedocs.io/
BSD 2-Clause "Simplified" License
38 stars 4 forks source link

[Feature Request] repo-button.html: add generic Gitweb button #152

Open CyberTailor opened 9 months ago

CyberTailor commented 9 months ago

For repositories, which canonical url points to Gitweb/Cgit/Gitea/et cetera

mgeier commented 9 months ago

Thanks for the suggestion!

I think there are no icons for that in Font-Awesome, though. I only found this: https://github.com/FortAwesome/Font-Awesome/issues/13274

But if you have your own icon, it's really easy to override the repo-button.html template, see https://insipid-sphinx-theme.readthedocs.io/en/0.4.2/customization.html#custom-templates

CyberTailor commented 9 months ago

I this a generic VCS icon would be good for that purpose. Like https://fontawesome.com/icons/git-alt or https://fontawesome.com/icons/code-branch

mgeier commented 9 months ago

OK, I see.

I think in this case it is more straightforward to overwrite the repo-button.html with a custom URL and icon. I have created some documentation for that: #154.

You can probably provide a better example href and title?