Normalize sections and chapters in Markdown
rutsky opened this issue · comments
- Articles has commented headers with different heading levels:
<!-- ### Теория модулей -->
<!-- # Паттерн «Модуль» -->
<!-- ##### Литеральная нотация объекта -->
- In some articles headings are used, e.g. in [1]:
### 1. Готова ли ваша архитектура к повторному использованию кода уже сейчас?
### 2. Сколько модулей в вашей системе зависит от других модулей?
But why third level?
In some articles headings are just in bold, e.g. in [2]:
**Dojo**
**YUI**
Oh, hard question. mb speak in russian? :D
But I totally understand your question. I need some time to remember the answer. But, anyway, you can change bold headings to correct 3rd levels. If i don't mistake, commented headers are used to compile epub.
Эгей, книга на русском языке и для русско-говорящих. Это один из тех редких случаев, когда русский язык в ишью уместен
Окей-окей :)
- Что сделать с уровнями заголовков в начале файла в комментариях?
<!-- ### Теория модулей -->
<!-- # Паттерн «Модуль» -->
<!-- ##### Литеральная нотация объекта -->
Их можно привести к одному уровню или уровень имеет какое-то значение? И если можно, то к какому?
- Заголовки внутри глав: наверно, стоит везде использовать именно заголовки (
###
). Тогда какого уровня? Почему именно третьего?
Посмотри, что получается после сборки электронных книг:
cd ./epub
cat ../_includes/translation/rus/[0-9]*.md | sed 's/<!-- //g' | sed 's/-->//g' > ./_source.md
pandoc epub.md -o largescale-js.epub --toc-depth=2 --epub-cover-image=cover.jpg --epub-chapter-level=2
pandoc epub.md -o largescale-js.fb2 --toc-depth=2 --epub-cover-image=cover.jpg --epub-chapter-level=2
kindleGen -c1 -locale ru largescale-js.epub -o largescale-js.mobi
Я уж не помню точно все детали
Так просто книги не собираются... epub.md
отстутствует, _sources.md вместо epub.md
не кушается pandoc-ом.
Было бы здорово, если бы для сборки книги был работающий Makefile :)
Вот баг про написание Makefile: #113