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
No, Markdown is the only supported format.
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