11 May
2022
11 May
'22
2:17 p.m.
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:
--
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/
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-framewo…
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 -- 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/
Daniel-Constantin Mierla
<miconda(a)gmail.com> writes:
--
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/
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. 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.