#mdbook — Public Fediverse posts

Mathieu David released #mdBook version 0.5.3. https://rust-lang.github.io/mdBook/

Mathieu David released #mdBook version 0.5.3. https://rust-lang.github.io/mdBook/

Mathieu David released #mdBook version 0.5.3. https://rust-lang.github.io/mdBook/

Mathieu David released #mdBook version 0.5.3. https://rust-lang.github.io/mdBook/

Mathieu David released #mdBook version 0.5.3. https://rust-lang.github.io/mdBook/

I don't write in Rust but I do love #mdBook.

I don't write in Rust but I do love #mdBook.

I don't write in Rust but I do love #mdBook.

I don't write in Rust but I do love #mdBook.

I don't write in Rust but I do love #mdBook.

Not sure it is the right order: our documentation is deployed before our backend is even online :-D
https://www.asfaload.com/doc/
The fastest way to deploy the doc was using https://rust-lang.github.io/mdBook/ , incidentally a #rustlang project like us.
#buildinpublic #mdbook #security #softwaresupplychain

Not sure it is the right order: our documentation is deployed before our backend is even online :-D
https://www.asfaload.com/doc/
The fastest way to deploy the doc was using https://rust-lang.github.io/mdBook/ , incidentally a #rustlang project like us.
#buildinpublic #mdbook #security #softwaresupplychain

#UANA community forums now provide a static DB dump in Markdown format: use /flarumdown URI to download in your network, e.g. http://[202:68d0:f0d5:b88d:1d1a:555e:2f6b:3148]/flarumdown/

As a bonus, here’s an open-source CLI tool in #Rust for other #Flarum v2 users:
https://github.com/YGGverse/flarumdown

What is next? Maybe Git publishing after tests, then #mdBook wiki, based on at least this dump.

#flarumdown

#UANA community forums now provide a static DB dump in Markdown format: use /flarumdown URI to download in your network, e.g. http://[202:68d0:f0d5:b88d:1d1a:555e:2f6b:3148]/flarumdown/

As a bonus, here’s an open-source CLI tool in #Rust for other #Flarum v2 users:
https://github.com/YGGverse/flarumdown

What is next? Maybe Git publishing after tests, then #mdBook wiki, based on at least this dump.

#flarumdown

#UANA community forums now provide a static DB dump in Markdown format: use /flarumdown URI to download in your network, e.g. http://[202:68d0:f0d5:b88d:1d1a:555e:2f6b:3148]/flarumdown/

As a bonus, here’s an open-source CLI tool in #Rust for other #Flarum v2 users:
https://github.com/YGGverse/flarumdown

What is next? Maybe Git publishing after tests, then #mdBook wiki, based on at least this dump.

#flarumdown

Mit Hubzilla kann man auch statische Webseiten anbieten, ohne das hubzilla-interne Webseiten-System zu nutzen... das geht mit der Cloud!

Hier drei Beispiele: mdBook, Hugo, Publii

Mit Hubzilla kann man auch statische Webseiten anbieten, ohne das hubzilla-interne Webseiten-System zu nutzen... das geht mit der Cloud!

Hier drei Beispiele: mdBook, Hugo, Publii

Mit Hubzilla kann man auch statische Webseiten anbieten, ohne das hubzilla-interne Webseiten-System zu nutzen... das geht mit der Cloud!

Hier drei Beispiele: mdBook, Hugo, Publii

Mit Hubzilla kann man auch statische Webseiten anbieten, ohne das hubzilla-interne Webseiten-System zu nutzen... das geht mit der Cloud!

Hier drei Beispiele: mdBook, Hugo, Publii

Mit Hubzilla kann man auch statische Webseiten anbieten, ohne das hubzilla-interne Webseiten-System zu nutzen... das geht mit der Cloud!

Hier drei Beispiele: mdBook, Hugo, Publii

Книга в Markdown: Автоматическая сборка статического сайта mdBook и файла DOCX с оформлением по ГОСТ

Текст книг, учебных пособий, научно-технических статей, документации, дипломных и курсовых работ часто набирается и редактируется в WYSIWYG-редакторе, таком как Microsoft Word, в том числе вследствие того, что издательства и организации требуют от авторов оформленный по ГОСТ или внутренним стандартам docx-документ. Процесс работы в Microsoft Word и аналогичных редакторах не лишён недостатков: docx-файлы трудно версионировать в git, а для объединения нескольких документов в один придётся перенумеровывать источники, рисунки, таблицы, формулы. Альтернативой docx является LaTeX. Однако работа со стилями в LaTeX простотой и минималистичным синтаксисом не отличается , причём издательства от использования формата docx отказываться не торопятся. А инструменты в духе typst отличаются нестандартным синтаксисом языка для описания документов, причём возможность генерации сайтов в typst имеет пометку «in preview». Markdown — популярный и удобный язык разметки, но это также и очень ограниченный формат. Поэтому задача написания в Markdown сложной технической документации по ГОСТ, научной статьи с автоматической настройкой оформления для заданного издательства или хорошо оформленного онлайн-учебника может показаться неосуществимой. В этой статье рассмотрим способ работы над научно-техническими статьями и книгами в формате Markdown на основе подхода Docs as Code с учётом строгих ограничений на оформление, используемый Петром Советовым @true-grue и мной при подготовке учебных материалов в РТУ МИРЭА. Способ заключается в применении утилиты pandoc для построения дерева абстрактного синтаксиса (AST) Markdown-документа с последующим переписыванием AST набором фильтров на Lua и трансляцией AST в форматы docx и pdf, соответствующие ГОСТ, а также в диалект markdown, совместимый с mdBook , для генерации онлайн-учебника в виде статического сайта. Исходный код книги , написанной с использованием описанного в статье подхода, опубликован на GitHub.

https://habr.com/ru/articles/987982/

#pandoc #markdown #lua #python #документирование #гост #docx #graphviz #mdbook #github

Книга в Markdown: Автоматическая сборка статического сайта mdBook и файла DOCX с оформлением по ГОСТ

Текст книг, учебных пособий, научно-технических статей, документации, дипломных и курсовых работ часто набирается и редактируется в WYSIWYG-редакторе, таком как Microsoft Word, в том числе вследствие того, что издательства и организации требуют от авторов оформленный по ГОСТ или внутренним стандартам docx-документ. Процесс работы в Microsoft Word и аналогичных редакторах не лишён недостатков: docx-файлы трудно версионировать в git, а для объединения нескольких документов в один придётся перенумеровывать источники, рисунки, таблицы, формулы. Альтернативой docx является LaTeX. Однако работа со стилями в LaTeX простотой и минималистичным синтаксисом не отличается , причём издательства от использования формата docx отказываться не торопятся. А инструменты в духе typst отличаются нестандартным синтаксисом языка для описания документов, причём возможность генерации сайтов в typst имеет пометку «in preview». Markdown — популярный и удобный язык разметки, но это также и очень ограниченный формат. Поэтому задача написания в Markdown сложной технической документации по ГОСТ, научной статьи с автоматической настройкой оформления для заданного издательства или хорошо оформленного онлайн-учебника может показаться неосуществимой. В этой статье рассмотрим способ работы над научно-техническими статьями и книгами в формате Markdown на основе подхода Docs as Code с учётом строгих ограничений на оформление, используемый Петром Советовым @true-grue и мной при подготовке учебных материалов в РТУ МИРЭА. Способ заключается в применении утилиты pandoc для построения дерева абстрактного синтаксиса (AST) Markdown-документа с последующим переписыванием AST набором фильтров на Lua и трансляцией AST в форматы docx и pdf, соответствующие ГОСТ, а также в диалект markdown, совместимый с mdBook , для генерации онлайн-учебника в виде статического сайта. Исходный код книги , написанной с использованием описанного в статье подхода, опубликован на GitHub.

https://habr.com/ru/articles/987982/

#pandoc #markdown #lua #python #документирование #гост #docx #graphviz #mdbook #github

Книга в Markdown: Автоматическая сборка статического сайта mdBook и файла DOCX с оформлением по ГОСТ

Текст книг, учебных пособий, научно-технических статей, документации, дипломных и курсовых работ часто набирается и редактируется в WYSIWYG-редакторе, таком как Microsoft Word, в том числе вследствие того, что издательства и организации требуют от авторов оформленный по ГОСТ или внутренним стандартам docx-документ. Процесс работы в Microsoft Word и аналогичных редакторах не лишён недостатков: docx-файлы трудно версионировать в git, а для объединения нескольких документов в один придётся перенумеровывать источники, рисунки, таблицы, формулы. Альтернативой docx является LaTeX. Однако работа со стилями в LaTeX простотой и минималистичным синтаксисом не отличается , причём издательства от использования формата docx отказываться не торопятся. А инструменты в духе typst отличаются нестандартным синтаксисом языка для описания документов, причём возможность генерации сайтов в typst имеет пометку «in preview». Markdown — популярный и удобный язык разметки, но это также и очень ограниченный формат. Поэтому задача написания в Markdown сложной технической документации по ГОСТ, научной статьи с автоматической настройкой оформления для заданного издательства или хорошо оформленного онлайн-учебника может показаться неосуществимой. В этой статье рассмотрим способ работы над научно-техническими статьями и книгами в формате Markdown на основе подхода Docs as Code с учётом строгих ограничений на оформление, используемый Петром Советовым @true-grue и мной при подготовке учебных материалов в РТУ МИРЭА. Способ заключается в применении утилиты pandoc для построения дерева абстрактного синтаксиса (AST) Markdown-документа с последующим переписыванием AST набором фильтров на Lua и трансляцией AST в форматы docx и pdf, соответствующие ГОСТ, а также в диалект markdown, совместимый с mdBook , для генерации онлайн-учебника в виде статического сайта. Исходный код книги , написанной с использованием описанного в статье подхода, опубликован на GitHub.

https://habr.com/ru/articles/987982/

#pandoc #markdown #lua #python #документирование #гост #docx #graphviz #mdbook #github

Книга в Markdown: Автоматическая сборка статического сайта mdBook и файла DOCX с оформлением по ГОСТ

Текст книг, учебных пособий, научно-технических статей, документации, дипломных и курсовых работ часто набирается и редактируется в WYSIWYG-редакторе, таком как Microsoft Word, в том числе вследствие того, что издательства и организации требуют от авторов оформленный по ГОСТ или внутренним стандартам docx-документ. Процесс работы в Microsoft Word и аналогичных редакторах не лишён недостатков: docx-файлы трудно версионировать в git, а для объединения нескольких документов в один придётся перенумеровывать источники, рисунки, таблицы, формулы. Альтернативой docx является LaTeX. Однако работа со стилями в LaTeX простотой и минималистичным синтаксисом не отличается , причём издательства от использования формата docx отказываться не торопятся. А инструменты в духе typst отличаются нестандартным синтаксисом языка для описания документов, причём возможность генерации сайтов в typst имеет пометку «in preview». Markdown — популярный и удобный язык разметки, но это также и очень ограниченный формат. Поэтому задача написания в Markdown сложной технической документации по ГОСТ, научной статьи с автоматической настройкой оформления для заданного издательства или хорошо оформленного онлайн-учебника может показаться неосуществимой. В этой статье рассмотрим способ работы над научно-техническими статьями и книгами в формате Markdown на основе подхода Docs as Code с учётом строгих ограничений на оформление, используемый Петром Советовым @true-grue и мной при подготовке учебных материалов в РТУ МИРЭА. Способ заключается в применении утилиты pandoc для построения дерева абстрактного синтаксиса (AST) Markdown-документа с последующим переписыванием AST набором фильтров на Lua и трансляцией AST в форматы docx и pdf, соответствующие ГОСТ, а также в диалект markdown, совместимый с mdBook , для генерации онлайн-учебника в виде статического сайта. Исходный код книги , написанной с использованием описанного в статье подхода, опубликован на GitHub.

https://habr.com/ru/articles/987982/

#pandoc #markdown #lua #python #документирование #гост #docx #graphviz #mdbook #github

Just released mdbook-variables 0.4.1 patch release with fixes in missing variable replace, release post: https://gitlab.com/tglman/mdbook-variables/-/releases/0.4.1
#mdbook #rust #mdbook-variables

Just released mdbook-variables 0.4.1 patch release with fixes in missing variable replace, release post: https://gitlab.com/tglman/mdbook-variables/-/releases/0.4.1
#mdbook #rust #mdbook-variables

Just released mdbook-variables 0.4.1 patch release with fixes in missing variable replace, release post: https://gitlab.com/tglman/mdbook-variables/-/releases/0.4.1
#mdbook #rust #mdbook-variables

Just released mdbook-variables 0.4.1 patch release with fixes in missing variable replace, release post: https://gitlab.com/tglman/mdbook-variables/-/releases/0.4.1
#mdbook #rust #mdbook-variables

Just released mdbook-variables 0.4.1 patch release with fixes in missing variable replace, release post: https://gitlab.com/tglman/mdbook-variables/-/releases/0.4.1
#mdbook #rust #mdbook-variables

Mathieu David released #mdBook version 0.5.2. https://rust-lang.github.io/mdBook/

Mathieu David released #mdBook version 0.5.2. https://rust-lang.github.io/mdBook/

Mathieu David released #mdBook version 0.5.2. https://rust-lang.github.io/mdBook/

Mathieu David released #mdBook version 0.5.2. https://rust-lang.github.io/mdBook/

Mathieu David released #mdBook version 0.5.2. https://rust-lang.github.io/mdBook/

Last week I released a new version of mdbook-variables, https://gitlab.com/tglman/mdbook-variables/-/releases/0.4.0 ( and https://crates.io/crates/mdbook-variables), this version update to #mdbook 0.5 and introduce a small fix that avoid to remove the variable name if its value is not defined, feel free to support my work on it on https://liberapay.com/mdbook-variables

Enjoy

Last week I released a new version of mdbook-variables, https://gitlab.com/tglman/mdbook-variables/-/releases/0.4.0 ( and https://crates.io/crates/mdbook-variables), this version update to #mdbook 0.5 and introduce a small fix that avoid to remove the variable name if its value is not defined, feel free to support my work on it on https://liberapay.com/mdbook-variables

Enjoy

Last week I released a new version of mdbook-variables, https://gitlab.com/tglman/mdbook-variables/-/releases/0.4.0 ( and https://crates.io/crates/mdbook-variables), this version update to #mdbook 0.5 and introduce a small fix that avoid to remove the variable name if its value is not defined, feel free to support my work on it on https://liberapay.com/mdbook-variables

Enjoy

Last week I released a new version of mdbook-variables, https://gitlab.com/tglman/mdbook-variables/-/releases/0.4.0 ( and https://crates.io/crates/mdbook-variables), this version update to #mdbook 0.5 and introduce a small fix that avoid to remove the variable name if its value is not defined, feel free to support my work on it on https://liberapay.com/mdbook-variables

Enjoy

mdBook 0.5 brings with it native table of contents generation (for pages with multiple headings), reducing the need for plugins and custom css

https://rust-lang.github.io/mdBook

#mdbook #rustlang

mdBook 0.5 brings with it native table of contents generation (for pages with multiple headings), reducing the need for plugins and custom css

https://rust-lang.github.io/mdBook

#mdbook #rustlang

mdBook 0.5 brings with it native table of contents generation (for pages with multiple headings), reducing the need for plugins and custom css

https://rust-lang.github.io/mdBook

#mdbook #rustlang

mdBook 0.5 brings with it native table of contents generation (for pages with multiple headings), reducing the need for plugins and custom css

https://rust-lang.github.io/mdBook

#mdbook #rustlang

Mathieu David released #mdBook version 0.5.1. https://rust-lang.github.io/mdBook/

Mathieu David released #mdBook version 0.5.1. https://rust-lang.github.io/mdBook/

Mathieu David released #mdBook version 0.5.1. https://rust-lang.github.io/mdBook/

Mathieu David released #mdBook version 0.5.1. https://rust-lang.github.io/mdBook/

Mathieu David released #mdBook version 0.5.1. https://rust-lang.github.io/mdBook/

Mathieu David released #mdBook version 0.5.0. https://rust-lang.github.io/mdBook/

Mathieu David released #mdBook version 0.5.0. https://rust-lang.github.io/mdBook/

Mathieu David released #mdBook version 0.5.0. https://rust-lang.github.io/mdBook/