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@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/
__________________________________________________________
Kamailio - Users Mailing List - Non Commercial Discussions
* sr-users@lists.kamailio.org
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