more on mdBook, Nav Summary page doesn't work well without https://github.com/rust-lang/mdBook/issues/167
So only mkdocs and pandoc left. On Thu, May 12, 2022 at 5:06 PM Daniel-Constantin Mierla <[email protected]> wrote: > More on emoji support with mkdocs: I installed the extensions but they > seem to point to CDN sites with links to svg/png images. This is also > done by github when browsing the files in the repo (they point to their > CND server), but I think it's not the optimal solution for the variant > to be stored on kamailio.org, because every time someone loads it from > our website, the emojis are downloaded from the remote CDN servers (can > be slower, privacy concerns, ...). > > Apparently it works to paste the UTF-8 character code for the emoji in > the md file and then all looks good in github repo and > mkdocs/mdbook/pandoc output. Therefore I think this is better to do. > > For now, my solution for getting the UTF-8 code for a specific emoji is > to select & copy the character from another file having it. For example > open in browser: > > * https://github.com/ikatyang/emoji-cheat-sheet/blob/master/README.md > > Then do "View source", search in it for the emoji you want, e.g.: > ":warning:" and you should find something like: > > <td align="center"><g-emoji class="g-emoji" alias="warning" > fallback-src=" > https://github.githubassets.com/images/icons/emoji/unicode/26a0.png > ">⚠️</g-emoji></td> > <td><code>:warning:</code></td> > > The character looks like a small image, respectively the yellow triangle > with exclamation before the end tag </g-emoji>. Select it, copy and > paste in the md file where you want to use it. > > Cheers, > Daniel > > On 11.05.22 14:17, Daniel-Constantin Mierla 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. 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/ > > > -- > 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 > -- Work: http://xswitch.cn Community: http://rts.cn About: http://about.me/dujinfang
__________________________________________________________ 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
