[SR-Users] Info: converting dokuwiki content to markdown files

[Daniel-Constantin Mierla]

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 <miconda at gmail.com> 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.  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
>> 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 -- 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 -- 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/