Support Gitea

[6543]

pleace correct me if you know a better description ...

currently docsy has integration for github (create issue, edit/create page, ...)
example:

the same feature for gitea would be nice

gitea issue: go-gitea/gitea#12303

[ShalokShalom]

Gitea is written in Go, by the way ;)
https://gitea.io

[LisaFC]

Anyone fancy taking this on? You'd need to update the config flags and then do a Gitea version (or update though it might get too Conditional Spaghetti) of this partial:
https://github.com/google/docsy/blob/master/layouts/partials/page-meta-links.html

[smainz]

There is already a PR #1310 to add Azure repos and I do have a working example for gitea.
To open question is, which direction to go for when adding more repo types.

Anyone got an Opinion?

[ShalokShalom]

Do you mean an universal API, or what exactly do you have in mind, categorically speaking?

[smainz]

In #1310 the repo links are already seperated into different files per repo type, but each repo type has its own parameters github_XXX or azure_XXX.

If you changed that to: e.g.

repo_type=azure
repo=<some_repo_url>
...

you can have this in page-meta-links.html

  {{ partial (printf "repo-links-%s.html" $repo_type) }}

This should give an idea how this could be done. Of course there needs to be some defaulting magic to not break existing configs for github.

This will allow

1. to bundle some repo types like github, azure, gitea and
2. provide a means for everyone to add a custom repo_type not already supported.

In contrast to what is done in #1310 you can have only one repo type, but extensible, whereas in the PR you can define github_XXX and azure_XXX parameters.

To be discussed: Should different repo_type for docs and project be supported?

[smainz]

@ShalokShalom #1941 should give an impression of what I want to do.