Interesting, do you know if it supports rendering emoji out of the box? For mkdocs I had to install some python extensions to get them built in the html output.
Cheers, Daniel On 12.05.22 08:47, Seven Du wrote: > found a new wheel lol: > > https://rust-lang.github.io/mdBook/index.html > > On Thu, May 12, 2022 at 10:36 AM Seven Du <[email protected]> wrote: > > I looked hugo today, and looks like we have to add yaml meta data > to each markdown file and relocate files to follow the hugo > convention. The worse things is, different themes have > different conventions. while we will eventually use one theme, but > it's not easy to try different themes, we will have to play > themes if we make it better later, but we don't want to be expert > on hugo. > > So as mkdocs kind of work, maybe we can stick with it. I also > played some css tricks to pin the TOC to the left of the page if > we use pandoc. the PR maybe not ready to merge before we figure > out the path problem. > > https://github.com/kamailio/kamailio-wiki/pull/5 > > On Wed, May 11, 2022 at 8:19 PM Daniel-Constantin Mierla > <[email protected]> wrote: > > > On 11.05.22 14:11, Daniel-Constantin Mierla wrote: > > I played a bit with mkdocs on kamailio-wiki files and > published the html > > output at: > > > > * https://www.kamailio.org/wikidocs/ > > Following up: I noticed mkdocs does not support emoji (which I > thought > of using to highlight paragraphs, notes, etc.), but there seem > to be > extensions for it. > > Cheers, > Daniel > > > > > > Some internal links may not work because I noticed warnings > when mkdocs > > was building the html pages, I will review and fix when I > get a chance. > > > > The kamailio-wiki gtihub repo has now a Makefile that > enables building > > html files using pandoc or mkdocs. Maybe someone can > contribute support > > for using hugo or other static site generator, then we can > decide in the > > community which result is better to publish on the website. > > > > Cheers, > > Daniel > > > > On 10.05.22 16:31, Daniel-Constantin Mierla wrote: > >> Thanks for the useful details about hugo! > >> > >> For the records, in the past we used the mkdocs for a couple of > >> tutorials, like the one for KEMI framework or install > guidelines, eg: > >> > >> * > https://www.kamailio.org/docs/tutorials/devel/kamailio-kemi-framework/ > >> > >> Built from: > >> > >> * > >> > > https://github.com/kamailio/kamailio-docs/tree/master/kamailio-kemi-framework > >> > >> But I can't say I am that familiar with it to assert if it > is the best > >> one for the wiki, which has lot of content and some pages > could end up > >> with large ToC (e.g., the cookbooks for core, variables, ...). > >> > >> Anyhow, let's have it in the list and see if we get more > feedback or > >> other suggestions from the community. > >> > >> Cheers, > >> Daniel > >> > >> On 10.05.22 13:01, Greg Troxel wrote: > >>> Daniel-Constantin Mierla <[email protected]> writes: > >>> > >>>> Ideally it is an app that can run on or behind a http > server/proxy and > >>>> serve html pages generated from the .md files directly > from the folder > >>>> with the clone of the github repo. But maybe I ask too > much and adapting > >>>> the wiki structure for a static site generator from .md > files is enough > >>>> or even better. > >>> I have been slowly converting my own content to hugo. > It's a very > >>> straightforward static site generator, and it runs very > quickly. > >>> > >>> It also has a built-in webserver, and by default it > watches the content > >>> files and provides the built website on port > 127.0.0.1:1313 <http://127.0.0.1:1313>. This is > >>> intended for previewing while editing - once you save a > file the browser > >>> window gets the new content in under a second. > >>> > >>> So if you either make hugo use your layout, or adapt to > hugo's idea of > >>> layout (which is quite sane), then not only can bits be > pushed to a > >>> server, but "hugo server" will make them available. > >>> > >>> So if I were tackling this, of all the options listed, I > would lean > >>> strongly to hugo. > >> -- > >> Daniel-Constantin Mierla -- www.asipto.com > <http://www.asipto.com> > >> www.twitter.com/miconda <http://www.twitter.com/miconda> -- > www.linkedin.com/in/miconda <http://www.linkedin.com/in/miconda> > >> Kamailio Advanced Training - Online: June 20-23, 2022 > >> * > https://www.asipto.com/sw/kamailio-advanced-training-online/ > >> > > -- > > Daniel-Constantin Mierla -- www.asipto.com > <http://www.asipto.com> > > www.twitter.com/miconda <http://www.twitter.com/miconda> -- > www.linkedin.com/in/miconda <http://www.linkedin.com/in/miconda> > > Kamailio Advanced Training - Online: June 20-23, 2022 > > * https://www.asipto.com/sw/kamailio-advanced-training-online/ > > > -- > Daniel-Constantin Mierla -- www.asipto.com <http://www.asipto.com> > www.twitter.com/miconda <http://www.twitter.com/miconda> -- > www.linkedin.com/in/miconda <http://www.linkedin.com/in/miconda> > Kamailio Advanced Training - Online: June 20-23, 2022 > * https://www.asipto.com/sw/kamailio-advanced-training-online/ > > > __________________________________________________________ > Kamailio - Users Mailing List - Non Commercial Discussions > * [email protected] > Important: keep the mailing list in the recipients, do not > reply only to the sender! > Edit mailing list options or unsubscribe: > * https://lists.kamailio.org/cgi-bin/mailman/listinfo/sr-users > > > > -- > About: http://about.me/dujinfang > Blog: http://www.dujinfang.com > Other: http://rts.cn > > > > -- > About: http://about.me/dujinfang > Blog: http://www.dujinfang.com > Other: http://rts.cn > -- Daniel-Constantin Mierla -- www.asipto.com www.twitter.com/miconda -- www.linkedin.com/in/miconda Kamailio Advanced Training - Online: June 20-23, 2022 * https://www.asipto.com/sw/kamailio-advanced-training-online/
__________________________________________________________ Kamailio - Users Mailing List - Non Commercial Discussions * [email protected] Important: keep the mailing list in the recipients, do not reply only to the sender! Edit mailing list options or unsubscribe: * https://lists.kamailio.org/cgi-bin/mailman/listinfo/sr-users
