largescaleJS_ru icon indicating copy to clipboard operation
largescaleJS_ru copied to clipboard

Normalize sections and chapters in Markdown

Open rutsky opened this issue 10 years ago • 8 comments

  1. Articles has commented headers with different heading levels:
<!-- ### Теория модулей -->

<!-- # Паттерн «Модуль» -->

<!-- ##### Литеральная нотация объекта -->
  1. 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**

[1] https://github.com/shuvalov-anton/largescaleJS_ru/blob/gh-pages/_includes/translation/rus/02_lets-review-your-current-architecture.md

[2] https://github.com/shuvalov-anton/largescaleJS_ru/blob/gh-pages/_includes/translation/rus/06_the-module-pattern.md

rutsky avatar Jan 22 '15 22:01 rutsky

Oh, hard question. mb speak in russian? :D

A avatar Jan 23 '15 09:01 A

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.

A avatar Jan 23 '15 09:01 A

Эгей, книга на русском языке и для русско-говорящих. Это один из тех редких случаев, когда русский язык в ишью уместен

iamstarkov avatar Jan 23 '15 10:01 iamstarkov

@matmuchrapna Ю а абсолютли райт дьюд хДДД @rutsky

A avatar Jan 23 '15 12:01 A

Окей-окей :)

  1. Что сделать с уровнями заголовков в начале файла в комментариях?
<!-- ### Теория модулей -->

<!-- # Паттерн «Модуль» -->

<!-- ##### Литеральная нотация объекта -->

Их можно привести к одному уровню или уровень имеет какое-то значение? И если можно, то к какому?

  1. Заголовки внутри глав: наверно, стоит везде использовать именно заголовки (###). Тогда какого уровня? Почему именно третьего?

rutsky avatar Jan 23 '15 13:01 rutsky

Посмотри, что получается после сборки электронных книг:

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

Я уж не помню точно все детали

A avatar Jan 23 '15 13:01 A

Так просто книги не собираются... epub.md отстутствует, _sources.md вместо epub.md не кушается pandoc-ом. Было бы здорово, если бы для сборки книги был работающий Makefile :)

rutsky avatar Jan 28 '15 00:01 rutsky

Вот баг про написание Makefile: #113

rutsky avatar Jan 28 '15 11:01 rutsky