Hi,
Is there a way to set README.rst as the project summary? I have set
README as the project summary but it seems that Sourcehut cannot render
the .rst file.
If we can only set README.md as the project summary, I suppose it's
better if we clarify it by changing the wording from README to README.md
Thanks, Salman
On 21/08/14 08:10, Drew DeVault wrote:
> No, Markdown is the only supported format.
Plain text is as well. I'm using it for most of my repositories.
On 8/13/21 6:32 PM, Salman Mohammadi wrote:
> Hi,
>
> Is there a way to set README.rst as the project summary? I have set
> README as the project summary but it seems that Sourcehut cannot render
> the .rst file.
>
> If we can only set README.md as the project summary, I suppose it's
> better if we clarify it by changing the wording from README to README.md
https://man.sr.ht/git.sr.ht/#setting-a-custom-readme
The hub is thematically the same, in that it only supports plain text
and interpreted markdown, and official policy is "sourcehut will never
add support for additional rendering formats" -- this is in fact why the
API supports uploading your own generated HTML snippets, IIRC.
In other words, if you want to use README.rst, you'll need to do extra
work to have it rendered on git.sr.ht, never mind the project hub. But,
the work is doable.
Since git supports uploading one via the API, it might be nice if the
hub did too... and in fact it does, since before checking for a readme
file from the "summary repo", it first checks for and uses a custom
readme returned by the git.sr.ht API.
See e.g. hubsrht/services.py get_readme() and try_html_readme()
--
Eli Schwartz
Arch Linux Bug Wrangler and Trusted User