#296 Wiki templates

Closed
opened 1 month ago by flu · 12 comments
flu commented 1 month ago

Does codeberg provide any wiki templates that can be used, e.g., for more colourful headers, rounded table headers etc. Or is the markdown all that is there, which is fantastic for technical documentation, but ... boring – you know.

Unfortunately, I can’t find any information about the Gitea wiki software at https://docs.gitea.io/en-us/, no clickable link. I even don’t know if Codeberg wiki software is based on Gitea, too, or someting else? Could anyone shed some light on how to unleash the power of the wiki?

Does codeberg provide any wiki templates that can be used, e.g., for more colourful headers, rounded table headers etc. Or is the markdown all that is there, which is fantastic for technical documentation, but ... boring – you know. Unfortunately, I can't find any information about the Gitea wiki software at https://docs.gitea.io/en-us/, no clickable link. I even don't know if Codeberg wiki software is based on Gitea, too, or someting else? Could anyone shed some light on how to unleash the power of the wiki?
6543 commented 1 month ago
Collaborator

if you mean the wiki for each repo: it’s a gitea feature

It use markdown to format stuff and can be pulled and pushed fia wiki url:
https://codeberg.org/<owner>/<project>.wiki.git

Or as most do: just edit via built in editor

if you mean the wiki for each repo: it's a gitea feature It use markdown to format stuff and can be pulled and pushed fia wiki url: `https://codeberg.org/<owner>/<project>.wiki.git` Or as most do: just edit via built in editor
6543 added the
question
label 1 month ago
flu commented 1 month ago
Poster

Yes, I’m talking about repository wikis. Thanks for confirming wiki software comes from Gitea. But I mean using colors in text, not the UI. Markdown isn’t made for visual web design and I wonder if there is a hidden feature like (parametrized) templates already present in Gitea’s wiki software. As far as I can see, Gitea seems not to be too strong at end-user documentation, unfortunately.

Yes, I'm talking about repository wikis. Thanks for confirming wiki software comes from Gitea. But I mean using colors in text, not the UI. Markdown isn't made for visual web design and I wonder if there is a hidden feature like (parametrized) templates already present in Gitea's wiki software. As far as I can see, Gitea seems not to be too strong at end-user documentation, unfortunately.
I'm afraid there's not a lot of styling possible in Markdown Wiki pages as of right now.

But did you know of Codeberg Pages? There, you can upload static HTML and design it to your heart’s content :)

As far as I can see, Gitea seems not to be too strong at end-user documentation, unfortunately.

Check out Codeberg Documentation for additional documentation - it’s very new, so please don’t expect too much just yet, but everyone’s invited to contribute new content at Codeberg/Documentation.

And of course, if you have more questions, feel free to ask :)

<center>I'm afraid there's not a lot of styling possible in Markdown Wiki pages as of right now.</center> But did you know of [Codeberg Pages](https://pages.codeberg.org)? There, you can upload static HTML and design it to your heart's content :) > As far as I can see, Gitea seems not to be too strong at end-user documentation, unfortunately. Check out [Codeberg Documentation](https://docs.codeberg.org) for additional documentation - it's very new, so please don't expect too much just yet, but everyone's invited to contribute new content at [Codeberg/Documentation](https://codeberg.org/Codeberg/Documentation). And of course, if you have more questions, feel free to ask :)
6543 commented 1 month ago
Collaborator

@flu there are errorts to allow inline css in markdown witch sanatized (removed) at the moment :/

If this is posible you can coloize what you want.
But this wont change the sittuation, that wiki pages are just markdown pages (with all it’s up and downs)

@flu there are errorts to allow inline css in markdown witch sanatized (removed) at the moment :/ If this is posible you can coloize what you want. But this wont change the sittuation, that wiki pages are just markdown pages (with all it's up and downs)
flu commented 1 month ago
Poster
I'm afraid there's not a lot of styling possible in Markdown Wiki pages as of right now.

I understand. And I’m well aware this is a code hosting site, less a wiki hosting site.

But did you know of Codeberg Pages? There, you can upload static HTML and design it to your heart’s content :)

Interesting. Unfortunately, I’m not exactly a web designer either. What I have in mind is just a tiny bit above Markdown’s feature level. Setting-up a local wiki or CMS instance then exporting the pages to HTML could be an option. Have to think about that. Does this pages feature allow more than one landing page?

> <center>I'm afraid there's not a lot of styling possible in Markdown Wiki pages as of right now.</center> I understand. And I'm well aware this is a code hosting site, less a wiki hosting site. > But did you know of [Codeberg Pages](https://pages.codeberg.org)? There, you can upload static HTML and design it to your heart's content :) Interesting. Unfortunately, I'm not exactly a web designer either. What I have in mind is just a tiny bit above Markdown's feature level. Setting-up a local wiki or CMS instance then exporting the pages to HTML could be an option. Have to think about that. Does this pages feature allow more than one landing page?
flu commented 1 month ago
Poster

@flu there are errorts to allow inline css in markdown witch sanatized (removed) at the moment :/

If this is posible you can coloize what you want.

Inline CSS would be fine. Is the current removal a bug or a (mis-)feature?

> @flu there are errorts to allow inline css in markdown witch sanatized (removed) at the moment :/ > > If this is posible you can coloize what you want. Inline CSS would be fine. Is the current removal a bug or a (mis-)feature?
6543 commented 1 month ago
Collaborator

@flu it’s for securety

and you always can set a “external wiki” if you need a more feature rich wiki. but that has to be hosted by you then ...

@flu it's for securety and you always can set a "external wiki" if you need a more feature rich wiki. but that has to be hosted by you then ...

Does this pages feature allow more than one landing page?

Please explain what you mean with more than one landing page.

> Does this pages feature allow more than one landing page? Please explain what you mean with more than one landing page.
flu commented 1 month ago
Poster

Oh yeah, got that ambigous. I mean just sub-pages. i.e., more than exactly one page.

Oh yeah, got that ambigous. I mean just sub-pages. i.e., more than exactly one page.

Yes, that’s absolutely possible with Pages :) You can do that by putting multiple HTML files in your pages repository and linking between them.

For a bit more comfort when building such a static website, have a look at static site generators, like for example Jekyll or Hugo. I think Hugo already comes with pre-defined themes, so you could write in Markdown and generate styled HTML which you can then upload to pages.

Yes, that's absolutely possible with Pages :) You can do that by putting multiple HTML files in your `pages` repository and linking between them. For a bit more comfort when building such a static website, have a look at static site generators, like for example Jekyll or Hugo. I think Hugo already comes with pre-defined themes, so you could write in Markdown and generate styled HTML which you can then upload to pages.
flu commented 1 month ago
Poster

OK, thank you! And thank you for pointing me to Hugo and Jekyll. They look indeed like a good option! And last, thank you for kindly answering my questions!

OK, thank you! And thank you for pointing me to Hugo and Jekyll. They look indeed like a good option! And last, thank you for kindly answering my questions!
flu closed this issue 1 month ago

You’re welcome :)

You're welcome :)
Sign in to join this conversation.
No Milestone
No Assignees
3 Participants
Notifications
Due Date

No due date set.

Dependencies

This issue currently doesn't have any dependencies.

Loading…
There is no content yet.