<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
</head>
<body>
<p>Interesting, do you know if it supports rendering emoji out of
the box?</p>
<p>For mkdocs I had to install some python extensions to get them
built in the html output.</p>
<p>Cheers,<br>
Daniel<br>
</p>
<div class="moz-cite-prefix">On 12.05.22 08:47, Seven Du wrote:<br>
</div>
<blockquote type="cite"
cite="mid:CAJs+-5psMBzKLDXiR+bu0K9UHpDE3hf5jBogb6Q11P1DbQDGxQ@mail.gmail.com">
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<div dir="ltr">found a new wheel lol:
<div><br>
</div>
<div><a href="https://rust-lang.github.io/mdBook/index.html"
moz-do-not-send="true" class="moz-txt-link-freetext">https://rust-lang.github.io/mdBook/index.html</a><br>
</div>
</div>
<br>
<div class="gmail_quote">
<div dir="ltr" class="gmail_attr">On Thu, May 12, 2022 at 10:36
AM Seven Du <<a href="mailto:dujinfang@gmail.com"
moz-do-not-send="true" class="moz-txt-link-freetext">dujinfang@gmail.com</a>>
wrote:<br>
</div>
<blockquote class="gmail_quote" style="margin:0px 0px 0px
0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
<div dir="ltr">
<div>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.</div>
<div><br>
</div>
<div>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.</div>
<div><br>
</div>
<a href="https://github.com/kamailio/kamailio-wiki/pull/5"
target="_blank" moz-do-not-send="true"
class="moz-txt-link-freetext">https://github.com/kamailio/kamailio-wiki/pull/5</a><br>
</div>
<br>
<div class="gmail_quote">
<div dir="ltr" class="gmail_attr">On Wed, May 11, 2022 at
8:19 PM Daniel-Constantin Mierla <<a
href="mailto:miconda@gmail.com" target="_blank"
moz-do-not-send="true" class="moz-txt-link-freetext">miconda@gmail.com</a>>
wrote:<br>
</div>
<blockquote class="gmail_quote" style="margin:0px 0px 0px
0.8ex;border-left:1px solid
rgb(204,204,204);padding-left:1ex"><br>
On 11.05.22 14:11, Daniel-Constantin Mierla wrote:<br>
> I played a bit with mkdocs on kamailio-wiki files and
published the html<br>
> output at:<br>
><br>
> * <a href="https://www.kamailio.org/wikidocs/"
rel="noreferrer" target="_blank" moz-do-not-send="true"
class="moz-txt-link-freetext">https://www.kamailio.org/wikidocs/</a><br>
<br>
Following up: I noticed mkdocs does not support emoji
(which I thought<br>
of using to highlight paragraphs, notes, etc.), but there
seem to be<br>
extensions for it.<br>
<br>
Cheers,<br>
Daniel<br>
<br>
<br>
><br>
> Some internal links may not work because I noticed
warnings when mkdocs<br>
> was building the html pages, I will review and fix
when I get a chance.<br>
><br>
> The kamailio-wiki gtihub repo has now a Makefile that
enables building<br>
> html files using pandoc or mkdocs. Maybe someone can
contribute support<br>
> for using hugo or other static site generator, then
we can decide in the<br>
> community which result is better to publish on the
website.<br>
><br>
> Cheers,<br>
> Daniel<br>
><br>
> On 10.05.22 16:31, Daniel-Constantin Mierla wrote:<br>
>> Thanks for the useful details about hugo!<br>
>><br>
>> For the records, in the past we used the mkdocs
for a couple of<br>
>> tutorials, like the one for KEMI framework or
install guidelines, eg:<br>
>><br>
>> * <a
href="https://www.kamailio.org/docs/tutorials/devel/kamailio-kemi-framework/"
rel="noreferrer" target="_blank" moz-do-not-send="true"
class="moz-txt-link-freetext">https://www.kamailio.org/docs/tutorials/devel/kamailio-kemi-framework/</a><br>
>><br>
>> Built from:<br>
>><br>
>> *<br>
>> <a
href="https://github.com/kamailio/kamailio-docs/tree/master/kamailio-kemi-framework"
rel="noreferrer" target="_blank" moz-do-not-send="true"
class="moz-txt-link-freetext">https://github.com/kamailio/kamailio-docs/tree/master/kamailio-kemi-framework</a><br>
>><br>
>> But I can't say I am that familiar with it to
assert if it is the best<br>
>> one for the wiki, which has lot of content and
some pages could end up<br>
>> with large ToC (e.g., the cookbooks for core,
variables, ...).<br>
>><br>
>> Anyhow, let's have it in the list and see if we
get more feedback or<br>
>> other suggestions from the community.<br>
>><br>
>> Cheers,<br>
>> Daniel<br>
>><br>
>> On 10.05.22 13:01, Greg Troxel wrote:<br>
>>> Daniel-Constantin Mierla <<a
href="mailto:miconda@gmail.com" target="_blank"
moz-do-not-send="true" class="moz-txt-link-freetext">miconda@gmail.com</a>>
writes:<br>
>>><br>
>>>> Ideally it is an app that can run on or
behind a http server/proxy and<br>
>>>> serve html pages generated from the .md
files directly from the folder<br>
>>>> with the clone of the github repo. But
maybe I ask too much and adapting<br>
>>>> the wiki structure for a static site
generator from .md files is enough<br>
>>>> or even better.<br>
>>> I have been slowly converting my own content
to hugo. It's a very<br>
>>> straightforward static site generator, and it
runs very quickly.<br>
>>><br>
>>> It also has a built-in webserver, and by
default it watches the content<br>
>>> files and provides the built website on port
<a href="http://127.0.0.1:1313" rel="noreferrer"
target="_blank" moz-do-not-send="true">127.0.0.1:1313</a>.
This is<br>
>>> intended for previewing while editing - once
you save a file the browser<br>
>>> window gets the new content in under a
second.<br>
>>><br>
>>> So if you either make hugo use your layout,
or adapt to hugo's idea of<br>
>>> layout (which is quite sane), then not only
can bits be pushed to a<br>
>>> server, but "hugo server" will make them
available.<br>
>>><br>
>>> So if I were tackling this, of all the
options listed, I would lean<br>
>>> strongly to hugo.<br>
>> -- <br>
>> Daniel-Constantin Mierla -- <a
href="http://www.asipto.com" rel="noreferrer"
target="_blank" moz-do-not-send="true">www.asipto.com</a><br>
>> <a href="http://www.twitter.com/miconda"
rel="noreferrer" target="_blank" moz-do-not-send="true">www.twitter.com/miconda</a>
-- <a href="http://www.linkedin.com/in/miconda"
rel="noreferrer" target="_blank" moz-do-not-send="true">www.linkedin.com/in/miconda</a><br>
>> Kamailio Advanced Training - Online: June 20-23,
2022<br>
>> * <a
href="https://www.asipto.com/sw/kamailio-advanced-training-online/"
rel="noreferrer" target="_blank" moz-do-not-send="true"
class="moz-txt-link-freetext">https://www.asipto.com/sw/kamailio-advanced-training-online/</a><br>
>><br>
> -- <br>
> Daniel-Constantin Mierla -- <a
href="http://www.asipto.com" rel="noreferrer"
target="_blank" moz-do-not-send="true">www.asipto.com</a><br>
> <a href="http://www.twitter.com/miconda"
rel="noreferrer" target="_blank" moz-do-not-send="true">www.twitter.com/miconda</a>
-- <a href="http://www.linkedin.com/in/miconda"
rel="noreferrer" target="_blank" moz-do-not-send="true">www.linkedin.com/in/miconda</a><br>
> Kamailio Advanced Training - Online: June 20-23, 2022<br>
> * <a
href="https://www.asipto.com/sw/kamailio-advanced-training-online/"
rel="noreferrer" target="_blank" moz-do-not-send="true"
class="moz-txt-link-freetext">https://www.asipto.com/sw/kamailio-advanced-training-online/</a><br>
><br>
-- <br>
Daniel-Constantin Mierla -- <a
href="http://www.asipto.com" rel="noreferrer"
target="_blank" moz-do-not-send="true">www.asipto.com</a><br>
<a href="http://www.twitter.com/miconda" rel="noreferrer"
target="_blank" moz-do-not-send="true">www.twitter.com/miconda</a>
-- <a href="http://www.linkedin.com/in/miconda"
rel="noreferrer" target="_blank" moz-do-not-send="true">www.linkedin.com/in/miconda</a><br>
Kamailio Advanced Training - Online: June 20-23, 2022<br>
* <a
href="https://www.asipto.com/sw/kamailio-advanced-training-online/"
rel="noreferrer" target="_blank" moz-do-not-send="true"
class="moz-txt-link-freetext">https://www.asipto.com/sw/kamailio-advanced-training-online/</a><br>
<br>
<br>
__________________________________________________________<br>
Kamailio - Users Mailing List - Non Commercial Discussions<br>
* <a href="mailto:sr-users@lists.kamailio.org"
target="_blank" moz-do-not-send="true"
class="moz-txt-link-freetext">sr-users@lists.kamailio.org</a><br>
Important: keep the mailing list in the recipients, do not
reply only to the sender!<br>
Edit mailing list options or unsubscribe:<br>
* <a
href="https://lists.kamailio.org/cgi-bin/mailman/listinfo/sr-users"
rel="noreferrer" target="_blank" moz-do-not-send="true"
class="moz-txt-link-freetext">https://lists.kamailio.org/cgi-bin/mailman/listinfo/sr-users</a><br>
</blockquote>
</div>
<br clear="all">
<div><br>
</div>
-- <br>
<div dir="ltr">
<div dir="ltr">About: <a href="http://about.me/dujinfang"
target="_blank" moz-do-not-send="true"
class="moz-txt-link-freetext">http://about.me/dujinfang</a><br>
Blog: <a href="http://www.dujinfang.com" target="_blank"
moz-do-not-send="true" class="moz-txt-link-freetext">http://www.dujinfang.com</a><br>
Other: <a href="http://rts.cn" target="_blank"
moz-do-not-send="true" class="moz-txt-link-freetext">http://rts.cn</a>
<div>
<div><br>
</div>
</div>
</div>
</div>
</blockquote>
</div>
<br clear="all">
<div><br>
</div>
-- <br>
<div dir="ltr" class="gmail_signature">
<div dir="ltr">About: <a href="http://about.me/dujinfang"
target="_blank" moz-do-not-send="true"
class="moz-txt-link-freetext">http://about.me/dujinfang</a><br>
Blog: <a href="http://www.dujinfang.com" target="_blank"
moz-do-not-send="true" class="moz-txt-link-freetext">http://www.dujinfang.com</a><br>
Other: <a href="http://rts.cn" target="_blank"
moz-do-not-send="true" class="moz-txt-link-freetext">http://rts.cn</a>
<div>
<div><br>
</div>
</div>
</div>
</div>
</blockquote>
<pre class="moz-signature" cols="72">--
Daniel-Constantin Mierla -- <a class="moz-txt-link-abbreviated" href="http://www.asipto.com">www.asipto.com</a>
<a class="moz-txt-link-abbreviated" href="http://www.twitter.com/miconda">www.twitter.com/miconda</a> -- <a class="moz-txt-link-abbreviated" href="http://www.linkedin.com/in/miconda">www.linkedin.com/in/miconda</a>
Kamailio Advanced Training - Online: June 20-23, 2022
* <a class="moz-txt-link-freetext" href="https://www.asipto.com/sw/kamailio-advanced-training-online/">https://www.asipto.com/sw/kamailio-advanced-training-online/</a></pre>
</body>
</html>