все вопросы по Anki задавайте на форуме  reddit.com/r/AnkiRu/ 

• AsciiDoctor

Файлы и Markdown

Чтобы отличить тексты, отформатированные под Markdown,
для файлов обычно используют расширение .md

а также .markdown .markdn и .mdown

Потренироваться: daringfireball.net/projects/markdown/dingus

Предупреждение Да, а как установить-то Perl и Markdown под Windows?

Форумы и Markdown

Также сей формат применяется и на некоторых форумах для оформления сообщений.
В частности, на форумах поддержки пользователей Anki.

При этом каждый форум старается внести какие-то особенности в свою реализацию.
Ну это чтобы жизнь мёдом не казалась.

 

tenderapp

anki.tenderapp.com официальный форум программы Anki

На этот форум можно писать и без регистрации,

но после регистрации появляется возможность

  • редактировать свои сообщения,

  • а также использовать для них простейшее форматирование

  • и установить свою аватарку.

Важно!
Аватарка важна
поскольку данный форум позволяет нескольким пользователям
использовать один и тот же ник.

В жизни же встречаются тёзки,
и это не является проблемой —
отвечает их техподдержка.

Однако и форматирование тоже ещё надо включить.

Просто найдите под правым нижним углом формы
Reply to this discussion Ответ на это обсуждение текст:

No formatting (switch to Markdown)

Без форматирования (переключиться на Markdown)
и кликните по ссылке (слову Markdown).

У вас появляется возможность в любой момент глянуть подсказку по форматированию, а также посмотреть, как будет выглядеть ваш пост без фактической отправки вашего сообщения на форум.

К сожалению, при редактировании сообщения возможности предпросмотра нет.
Видимо, считается, что ты и так ведаешь, что вытворяешь.

И таки да, всегда можно переключаться между режимами туда-сюда-обратно.

Параграфы

Несколько строк текста подряд между пустыми строками (либо началом или концом сообщения) считаются параграфом.

Разбиение на строки внутри параграфа не сохраняется, весь текст в сообщении будет идти сплошняком.

Чтобы указать перевод строки внутри параграфа, добавьте в конце такой строки два пробела.

Подсказка по форматированию

Предложение использует синтаксис Markdown для форматирования текста.

  • *одиночные звёздочки*: курсив
  • **двойные звёздочки**: полужирный
  • `одиночные обратные кавычки`: текст кода внутри строки обычного текста
  • [например.сом](http://example.com): ссылка на сайт
  • ![пикча](http://example.com/image.jpg): картинка внутри строки
    • 
      * пули точки после пустой строки
      * пункты маркированного списка (жирные точки)
        - под-список задаётся отступом вправо на два пробела
        - завершение списков обозначается пустой строкой
      
      
    • > цитировать ответ
      цитата
    • блок кода: строка из трёх обратных кавычек после пустой строки и перед ней
      некий текст
      
      ```
      say 'Hello,' whoisuser'.'
      pull answer
      ```
      
      ещё больше какого-то текстика

некий текст

say 'Hello,' whoisuser'.'
pull answer

ещё больше какого-то текстика

P.S. одиночные обратные кавычки набираются на английской раскладке клавиатуры той же клавишей, что и Ё на русской (прямо под клавишей Esc в левом верхнем углу)

Честно говоря, не видел ни разу, чтобы кто-то на этом форуме пользовался возможностью
указать внутри текста картинку, размещённую на стороннем сайте,
скажем, таком как fastpic.ru или savepic.ru

Как и двухуровневых списков тоже не встречал.

Явно об этом в подсказке не говорится, но
цитата может быть вложенной:

Bye!
> You are welcome!
>> OK

Таблички

Сразу во всю возможную ширину, не по данным.

Слегка стильное оформление, линии только по строкам.

Строка с чёрточками под заголовком обязательна,

иначе это будет просто параграф обычного текста.
Правда, с переносом по строкам почему-то.

Column A | Column B | Column C
-|-|-
A1 | B1 | C1
A2 | B2 | C2
Вот тоже ни разу не видал их использования.

 

reddit

Сайт неплохо русифицирован, и это хорошо!
Возможности предпросмотра нет, и это плохо!

Код оформлен иначе, минимум 4етыре пробела приходится добавлять в начале каждой строки.

Зачем-то добавлена возможность зачёркивания, видимо, обозначить, что именно исправил при редактировании сообщения.

Это актуально разве что для законов и прочих указаний.
В нормальной жизни текст, потерявший актуальность, не надо зачёркивать.
Его надо просто удалять. На крайняк — скрывать под спойлером.

чуть подробнее

Стили реддита настроены таким образом, что пробел между параграфами едва заметен.

Если же вам нужна заметная пустая полоса между параграфами, то
добавляйте пустой параграф, то есть состоящий из единственного непустого пробела:

Текст, текст, текст.

Какой-то текст.

 

И текст следом.
Про таб вместо 4етырёх пробелов — это у них смешно написано.

Нажатие на клавишу табуляции просто уводит курсор из поля для набора сообщения.
Видимо, подразумевается копипаста текста, предварительно набранного в текстовом редакторе.
Куска исходника, попросту говоря.

Таблицы

Column A | Column B | Column C | Column D
-|-|---------------------|-
A1 | B1 | C1 | D1
A2 | B2 | C2 | D2

В отличие от `tenderapp` поддерживается выравнивание:

Column L | Column C | Column R | Column D
:--------|:--------:|---------:|---
L1 | C1 | R1 | D1
L2 | C2 | R2 | D2
L3 | C3 | R3 | 123

Количество минусов в строке никак не определяет ширину колонки,
всё равно всё будет ровно по данным:

К сожалению, колонка без форматирования не опознаёт числовые ячеки
и не выравнивает их по правому краю автоматически :о)

 

Ru-Board

тут немного другая система, bbcode называется

но суть прежняя: i.ru-board.com/codes.html

(базовое оформление слов, ссылки, списки, таблички, картиночки)

 

Power Format Pack addon

и Markdown

И???

Wikipedia и Markdown

Markwiki

И???

manual.txt

В разделе Переводы руководства говорится:

Если вы достаточно хорошо подкованы технически, то вы можете захотеть перевести исходный файл этого руководства и скомпилировать его самостоятельно с помощью asciidoc. Вы также можете использовать github репозитарий Anki manual.txt для отслеживания изменений в этом руководстве в будущем.

Если сказанное звучит для вас слишком сложно, то проще будет будет сохранить эту страницу локально у себя на диске напрямую из браузера по команде File → Save As…​, затем открыть её в Microsoft Office Word или любой другой похожей программе (например, LibreOffice Writer), и выполнить перевод таким образом.

— Дамиен Элмс
Руководство пользователя программы Anki 2.0

Да, лаконичненько.

Подсказка
Если всё, что вы можете сказать о компьютерах:
ЭВМ — это слишком сложно для меня,
и готовы удовольствоваться вордом, то этот раздел можете смело пропустить.

Если же вы хотите прослыть хорошо подкованным технически, то приступим.

Для меня самый простой путь начать знакомство с предметом,
о котором я слышу первый раз в жизни — вики.

Да, там любительски, да, там не очень-то и достоверно,

но это прекрасная альтернатива гуглению, где придётся пробираться
буквально через горы спама, фишинговых сайтов, дистрибутивов с вирусами и т.п.

AsciiDoc

Да, только по-английски. Увы.

Итак, что уже можно понять?

Это входной формат — простой (плоский – plain англ.) текст, оформленный по несложным правилам на основе облегченного языка разметки для последующего преобразования с помощью программы в какой-нибудь заметно более сложный для составления человеком вручную выходной формат (HTML, XML, TeX, man и др.)

Простой текст — именно в этот формат сохраняет Блокнот (notepad.exe)
Обычное расширение для такого файла .txt

Примечание Форматы .doc и .rtf далеко не просты — помимо самого текста, они содержат информацию о шрифте, цвете, заголовках и многом другом. Вплоть до таблиц и изображений.

AsciiDoc был создан в 2002 году новозеландцем Stuart Rackham
в виде пары утилит asciidoc и a2x, написанных на языке программирования Python.

Некоторые книги издательства O’Reilly были подготовлены авторами в формате AsciiDoc.

Большая часть документации проекта Git (система контроля версий) написана на AsciiDoc.

Например

Так выглядит типичный текст sidorov.txt в формате AsciiDoc

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
 = Моя первая книжка
 Иван Петрович Сидоров

 Сидорову-старшему посвящается

 == Не сложилось у песни начало

 [quote, Аркадий Райкин, Люди и манекены]
 Меня, Сидорова-мл., мой отец, Сидоров-ст., драл как сидорову козу.
 И ничего, целое поколение выросло.

 Пример двойной рифмы, кстати говоря:

 [verse, Владимир Асмолов, Фантасмагория (Оловянная душа 1988)]
 Вот и вся история Любви моей.
 Фантасмагория - Игра теней!

 https://www.artlebedev.ru/kovodstvo/sections/66/

 **Lorem ipsum** __dolor sit amet__, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Да, файл должен быть именно в кодировке UTF-8 без BOM (byte order mark).

Команда на трансляцию под Windows выглядит как-то так:
c:\python27\asciidoc-8.6.9\asciidoc.py sidorov.txt

Выходной файл будет sidorov.html в формате XHTML 1.1

Но это если только второй python установлен в системе.
Если же нужен и третий одновременно, то

можно явно указать, каким именно питоном и в какой именно файл:
C:\Python27\python.exe c:\python27\asciidoc-8.6.9\asciidoc.py -o sidorov.xhtml sidorov.txt

Название выходного файла будет точнее отражать суть его содержимого: sidorov.xhtml

Python не ниже версии 2.4, но только второй,
под Python 3 AsciiDoc не работает.

Чтобы отличить тексты, отформатированные под AsciiDoc,
для файлов обычно используют расширение .adoc реже .asciidoc .asc .ad

Доки

www.methods.co.nz/asciidoc/ AsciiDoc Home Page

asciidoc.org/ Text based document generation

Шикарная шпаргалка

AsciiDoc cheatsheet by POWERMAN

"In each of us sleeps a genius…​ and his sleep gets deeper everyday."

К сожалению, он уже не так шикарен.

и др.

Предупреждение Да, а как установить-то Python и AsciiDoc под Windows?

Выходные форматы

HTML

в вариантах XHTML 1.1, HTML4, HTML5

DocBook

XML-формат для создания книг.

PDF

Красиво, конечно, но что для этого надо сделать — пока непонятно.

man

Самое узкое применение, в основном для линуксоидов:

подготовка документации в формате УНИХ.

Что в итоге

А по итогу мне очень быстро надоело переводить мануал под AsciiDoc

  • Транслятор работает ооо-о-о-очень медленно, минуту практически.

  • Результат работы выглядит так, как будто она сделана очень давно, ещё в начале века, и как его осовременить своими стилями без того, чтобы потратить на это тучу времени и сил — непонятно.

  • Ладно бы только выглядел, это ещё полбеды, читать такой текст неудобно — вот главная проблема.

  • Как к этому результату прикрутить динамическое оглавление — поди разберись.
    Дамиен, как видите, никаких указаний по этому поводу не даёт.

AsciiDoctor

AsciiDoctor был создан в 2013 году на языке программирования Ruby
в развитие застывшего проекта AsciiDoc

Основные отличия:
  • работает раз в 10 быстрее,

  • добавлены некоторые весьма удобные фишки,

  • используется   проектом   GitHub

  • и позволяет использовать возможности AsciiDoc в рамках экосистемы языка Java

Предупреждение Да, а как установить-то Ruby и AsciiDoctor под Windows?

Пример

Команда на трансляцию примера под Windows выглядит как-то так:
asciidoctor -o sidorov.htm sidorov.txt

Выходной файл будет sidorov.htm в формате HTML5

Выглядит уже намного бодрее, если бы не эта мрачная чёрная лента внизу, да ещё со сбитой кодировкой :-(

Но есть атрибут, который позволяет это дело отключить:
asciidoctor -a nofooter -o sidorov.html sidorov.txt

sidorov.html Только не очень понятно, что текст уже закончился и большего ожидать не следует.

Можно убрать только дату с полосы:
asciidoctor -a last-update-label! -o sidoroff.html sidorov.txt

Но этот вариант плох на коротких текстах, поскольку у них чёрная полоса висит посередь веб-страницы.
Особенно плохо, если экран широкий :-)

Примечание Если в первом случае атрибут nofooter назначается,
то во втором действующий по умолчанию атрибут last-update-label отменяется,
на что указывает восклицательный знак после его имени.
Осторожно!
Обратите внимание!
AsciiDoc и AsciiDoctor в разной последовательности указывают автора и источник цитаты. Интересно, а как требуется по ГОСТу?

 

вставка видео с YouTube

Не всякое видео получится запустить с вашей html-страницы. Канал на Ютубе должен разрешать это.

Некоторые музыкальные каналы, например, разрешают показывать свои видео в жж или вк, но не допускают этого на любых других платформах.

размеры видео

Рекомендуемое разрешение и соотношение сторон

Чтобы видео полностью занимало окно проигрывателя, используйте следующие разрешения:

  • 2160p: 3840x2160
  • 1440p: 2560x1440
  • 1080p: 1920x1080
  • 720p: 1280x720
  • 480p: 854x480
  • 360p: 640x360
  • 240p: 426x240
Последние три размера в списке

вполне нормально встраиваются в текст AsciiDoctor.

Что ещё?

.rst

???

 

 

© 2017-06-08
Несмотря на то, что текст опубликован в свободном доступе, все права на него оставляю за собой.
Если вам необходимо где-то использовать весь текст или его часть — напишите мне и мы обсудим.

Свои вопросы и предложения по Anki засылайте  на форум  reddit.com/r/AnkiRu/ 

P.S. Все имена и события вымышлены. Все совпадения случайны.
Все торговые марки принадлежат их владельцам,
случайные упоминания в тексте не являются покушением на их использование.

И вообще, вам это всё привиделось. Было сном.

Немедленно сотрите у себя этот файл и забудьте то, что прочитали :-)

.

.