Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Normalize sections and chapters in Markdown #147

Open
rutsky opened this issue Jan 22, 2015 · 8 comments
Open

Normalize sections and chapters in Markdown #147

rutsky opened this issue Jan 22, 2015 · 8 comments

Comments

@rutsky
Copy link
Contributor

rutsky commented Jan 22, 2015

  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

@A
Copy link
Owner

A commented Jan 23, 2015

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

@A
Copy link
Owner

A commented Jan 23, 2015

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.

@iamstarkov
Copy link
Collaborator

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

@A
Copy link
Owner

A commented Jan 23, 2015

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

@rutsky
Copy link
Contributor Author

rutsky commented Jan 23, 2015

Окей-окей :)

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

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

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

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

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

@A
Copy link
Owner

A commented Jan 23, 2015

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

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

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

@rutsky
Copy link
Contributor Author

rutsky commented Jan 28, 2015

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

@rutsky
Copy link
Contributor Author

rutsky commented Jan 28, 2015

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

@becubie becubie moved this to In Progress in python project May 13, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

3 participants