Разметки

Здравствуйте, flаt, Вы писали:
V>>Для примера я упёрся в возможности структурных редакторов Индексация в личных базах знаний

Автор: velkin
Дата: 20.03.24

, в итоге пришлось переходить на html5.
F>Markdown не поможет? Писать на голом html заметки — такое себе развлечение.

Я за жизнь использовал множество разметок в веб-движках, текстовых и wysiwyg редакторах.

Из популярных.
1. Html.
2. BBCode
3. Markdown.
4. Wiki-разметка.

Из специальных.
1. Ascii-doctor.
2. Doxygen.
И множество других.

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

Простота

Когда топят за "не html" часто упирают на простоту. Но давайте разберём, что такое простота и так ли это на самом деле.

Текст без разметок называется простым — простой текст. Разметки это по сути вставки в этот текст. Хотя иногда приходится менять спец. символы, например, в html "<" на "&lt;" или ">" на "&gt;".

Заголовки

Простой текст

Заголовок 1

Заголовок 6

Html

<h1>Заголовок 1</h1>
<h6>Заголовок 6</h6>

BBCode

[h1]Заголовок 1[/h1]
[h6]Заголовок 6[/h6]

Wiki-разметка

= Заголовок 1 =
====== Заголовок 6 ======

Или наоборот типа Zim

====== Заголовок 1 ======
= Заголовок 6 =

Markdown

# Заголовок 1
###### Заголовок 6

На этих примерах пока сложно разглядеть главное преимущество html и почему эта разметка гораздо проще, чем другие. BBCode в расчёт не беру, это по сути обрезанная версия html с неочевидным набором, но об этом позже.

Параграф (абзац)

Простой текст

Параграф 1.

Параграф 2.

Html

<p>Параграф 1.</p>

<p>Параграф 2.</p>

BBCode

Параграф 1.

Параграф 2.

Wiki-разметка

Параграф 1.

Параграф 2.

Markdown

Параграф 1.

Параграф 2.

И казалось бы html проигрывает всем упрощённым разметкам, ведь нужно набрать больше текста. Но уже можно говорить о том, что html пока что однообразен, тогда как остальные разметки нет.

В html есть простое правило, все теги имеют шаблоны <></> или <>. Пока тегов немного кажется, что можно смухлевать. Как здесь, использовать для разделения параграфов по сути отсутствие форматирования и оставить простой текст.

Выделение текста

Простой текст

жирный
курсив
подчёркнутый
зачёркнутый

Html

<b>жирный</b>
<i>курсив</i>
<u>подчёркнутый</u>
<s>зачёркнутый</s>

BBCode

из-за движка rsdn не отобразить, но это калька html, где вместо <> используется []

Wiki-разметка

**жирный**
//курсив//
__подчёркнутый__
~~зачёркнутый~~

Markdown

**жирный** __жирный__
*курсив* _курсив_
подчёркнутый
~~зачёркнутый~~

1. Html по прежнему однообразен в использовании и это огромный плюс к простоте.
2. BBCode просто тупо копирует html.
3. Wiki-разметка, которую я взял с Zim, использует слишком много символов, которые бы пригодились в тексте.
3. Markdown оказался недоделанным по подчёркиванию и имеет несколько повторений по синтаксису.

Кто ещё думает, что запомнить теги bius и вложить их в шаблон <></> сложнее, чем какую-то ерунду из знаков.

Вложение выделения текста

Простой текст

жирный курсив подчёркнутый зачёркнутый

Html

<b><i><u><s>жирный курсив подчёркнутый зачёркнутый</s></u></i></b>

BBCode

из-за движка rsdn не отобразить, но это калька html, где вместо <> используется []

Wiki-разметка

//**__~~жирный курсив подчёркнутый зачёркнутый~~__**//

Markdown

а хрен его знает

Дальше не буду приводить примеры, потому что мне надоело.

Списки

Списки в html чуть сложнее, чем в "упрощённых разметках".

Многоуровневые списки

Синтаксис многоуровневых списков в html сильно сложнее.

Таблицы

Таблицы в html гораздо проще для восприятия, чем в других синтаксисах и набирать их проще.

Гиперссылки

Возможности гиперссылок и установки якорей в html с тегом id в разы лучше любых упрощённых разметок. Это киллер фича, которая делает другие разметки попросту бесполезными. Более того, упрощённые разметки к этому времени уже совсем попутали берега со сложностью набора. Сложность заключается в том, что вместо всё тех же шаблонов <></> и <> я должен выучить ещё что-то.

Изображения

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

Видео, аудио

Html5 поддерживает файлы на локальном диске video, audio, так и вставку iframe с того же youtube.

Для пример.

С диска.

<video src="songa.mp4" height="240px" controls></video>

С youtube

<iframe src="https://www.youtube.com/embed/uQotvEi4-Zw"></iframe>

Эти конструкции очень просты, а результат великолепен. Упрощённые разметки, зачем?

Код в параграфе

Выделение кода в параграфе, тех же идентификаторов и прочего, чтобы он отличался от остального текста.

<code></code>

Код с синтаксической подсветкой

Для примера подсветка highlight.js c++.

<pre><code class="cpp"></code></pre>

Ключевая ошибка новичков в использовании html5

Собственно главная ошибка в переусложнении. Люди видят множество тегов и начинают из них генерировать франкенштейна.

Они не могут понять, что
1. используй они html5 с минимальным функционалом соответствующий упрощённым разметкам,
2. причём с точно такими же отступами для удобного просмотра как в упрощённых разметках,
3. то и простота работы была бы даже лучше, чем в упрощённых разметках за счёт однообразия.

Им надо проходить не курс как сгенерировать страничку сайта на несколько десятков мегабайт, а как создать человеко читаемые html страницы.

Тот пример, который я привёл в предыдущем комментарии в DreamWeaver выглядит так.



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



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

Почему вы лоханётесь с упрощёнными разметками

Здесь надо бы написать полноценную статью с полноценным сравнением разметок. Что пытались сделать и что в итоге получилось. Мне надоело писать, я упустил важные моменты, вроде масштабирования изображений, или якоря ссылок. Всё то, что в упрощённых разметках не просто раздражает, а вообще не даёт реализовать задумку в html5 делается элементарно, это базовый функционал.

Я даже не говорю про какое-то сложное форматирование сайтов или ещё чего. Речь именно о личных заметках. Мне тоже в своё время промыли мозги. Да я знал, что есть html4, а потом и html5, но начитался про markdown. И сам ходил такой, о ребята, смотрите, что я обнаружил, markdown, это круто и просто.

Markdown много где есть, в веб-движках, особенно его любят рубисты, вроде GitHub (Markdown) или Redmine (Markdown). Между прочим нет чёткого всемирного стандарта Markdown и его любят мешать с html, когда чего-то не хватает.

А есть ещё генераторы статических сайтов вроде Jekyll_. Типа берёшь Markdown и начинаешь фигачить заметки. Можно даже скачать специализированный редактор чисто под Markdown. Конечно, ведь написать на Markdown якобы проще, чем на html5?

Но как показывает практика, Markdown гораздо сложнее html5 в использовании и гораздо менее функционален. При этом html5 открывается во множестве браузеров и имеет стандартные валидаторы. А браузеры настолько вылизаны, что софт для упрощённых разметок с ними даже рядом не лежал.

Это получается у всех на виду html и в частности html5. На чём построен интернет с точки зрения данных? Понятно же, на html. Но люди смотрят в книгу, видят фигу. Причём я не говорю, что я умный, сразу догадался, что html5 это лучшее решение на рынке.

Нет, меня точно так же развели упрощёнными разметками, в том числе и Markdown. Может быть в каком-нибудь веб-движке для "защиты" и есть смысл в упрощённых разметках, чтобы не внедрили sql-инъекцию, или какой-нибудь html код взламывающий сайт. Но на собственных заметках, которые по сути являются готовым статическим сайтом это всё не нужно.

Да, хотя html4, а потом html5 был всегда у меня на виду, мне понадобилось лохануться и не раз чтобы понять мощь этой технологии в том числе в частном использовании. Что не нужны упрощённые разметки, и что они сложнее в использовании. Что не нужны генераторы в html, это лишнее звено, проще сразу использовать html.

Пока у людей 100 или даже 1000 заметок, они могут этого не замечать. Но практически любой заметит проблему по достижении условных 10'000 заметок. Люди начинают спрашивать, я дошёл до такого-то числа заметок или гиперссылок, почему у меня всё тормознуло в структурном редакторе вроде Zim, как это исправить. Или в Obsidian с его Markdown загружается куча времени.

Ну как это исправить? Перейти на html5. А что вы хотели? И нельзя не лохануться, потому что люди топящие за упрощённые разметки никогда не работали с 10'000 заметок. Вот у меня книга Страуструпа "Язык программирования C++" вышла на 850 html страниц. Не печатных страниц, а это просто главы.

А у меня больше сотни книг по программированию, которые я хотел прочитать и не прочитал, в основном по C++. Если создавать заметки по программам или библиотекам алгоритмов, там в одной только библиотеке может быть больше 10'000 заметок, а интересных программ и библиотек может быть сотни или тысячи. В сумме заметок может быть миллионы или десятки миллионов, но замороченные на этом люди обычно доcтигают до 100'000 .

Ну вот писали в Markdown, писали, потом поняли, что не хватает возможностей, таких как функционала или отображенияв браузере. А уже сколько всего написано. Да и теги html для поиска и замены символами подстановки или регулярными выражениями гораздо проще, чем сборная солянка упрощённых разметок вроде Markdown и прочих.

Никогда не говори никогда

Короче я не буду говорить, что никогда не используй то, и никогда не используй это. Меня уже столько раз разводили на языки программирования и языки разметок, что уже начинаешь сомневаться в собственной адекватности.

Лучший язык программирования C++.
Лучший язык разметок Html5.

Да та же самая ня, только в профиль. Что я только не изучал .NET, или Delphi, или Pascal, или QuickBasic и ещё куча других. Это всё тупое разводилово, даже C#. Кто не верит тот может одеть на себя значок "Я не лох".

Лох это судьба

https://www.youtube.com/watch?v=iTnaQd-EKbA

Разметки

Здравствуйте, flаt, Вы писали:
V>>Для примера я упёрся в возможности структурных редакторов Индексация в личных базах знаний

Автор: velkin
Дата: 20.03.24

, в итоге пришлось переходить на html5.
F>Markdown не поможет? Писать на голом html заметки — такое себе развлечение.

Я за жизнь использовал множество разметок в веб-движках, текстовых и wysiwyg редакторах.

Из популярных.
1. Html.
2. BBCode
3. Markdown.
4. Wiki-разметка.

Из специальных.
1. Ascii-doctor.
2. Doxygen.
И множество других.

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

Простота

Когда топят за "не html" часто упирают на простоту. Но давайте разберём, что такое простота и так ли это на самом деле.

Текст без разметок называется простым — простой текст. Разметки это по сути вставки в этот текст. Хотя иногда приходится менять спец. символы, например, в html "<" на "&lt;" или ">" на "&gt;".

Заголовки

Простой текст

Заголовок 1

Заголовок 6

Html

<h1>Заголовок 1</h1>
<h6>Заголовок 6</h6>

BBCode

[h1]Заголовок 1[/h1]
[h6]Заголовок 6[/h6]

Wiki-разметка

= Заголовок 1 =
====== Заголовок 6 ======

Или наоборот типа Zim

====== Заголовок 1 ======
= Заголовок 6 =

Markdown

# Заголовок 1
###### Заголовок 6

На этих примерах пока сложно разглядеть главное преимущество html и почему эта разметка гораздо проще, чем другие. BBCode в расчёт не беру, это по сути обрезанная версия html с неочевидным набором, но об этом позже.

Параграф (абзац)

Простой текст

Параграф 1.

Параграф 2.

Html

<p>Параграф 1.</p>

<p>Параграф 2.</p>

BBCode

Параграф 1.

Параграф 2.

Wiki-разметка

Параграф 1.

Параграф 2.

Markdown

Параграф 1.

Параграф 2.

И казалось бы html проигрывает всем упрощённым разметкам, ведь нужно набрать больше текста. Но уже можно говорить о том, что html пока что однообразен, тогда как остальные разметки нет.

В html есть простое правило, все теги имеют шаблоны <></> или <>. Пока тегов немного кажется, что можно смухлевать. Как здесь, использовать для разделения параграфов по сути отсутствие форматирования и оставить простой текст.

Выделение текста

Простой текст

жирный
курсив
подчёркнутый
зачёркнутый

Html

<b>жирный</b>
<i>курсив</i>
<u>подчёркнутый</u>
<s>зачёркнутый</s>

BBCode

из-за движка rsdn не отобразить, но это калька html, где вместо <> используется []

Wiki-разметка

**жирный**
//курсив//
__подчёркнутый__
~~зачёркнутый~~

Markdown

**жирный** __жирный__
*курсив* _курсив_
подчёркнутый
~~зачёркнутый~~

1. Html по прежнему однообразен в использовании и это огромный плюс к простоте.
2. BBCode просто тупо копирует html.
3. Wiki-разметка, которую я взял с Zim, использует слишком много символов, которые бы пригодились в тексте.
3. Markdown оказался недоделанным по подчёркиванию и имеет несколько повторений по синтаксису.

Кто ещё думает, что запомнить теги bius и вложить их в шаблон <></> сложнее, чем какую-то ерунду из знаков.

Вложение выделения текста

Простой текст

жирный курсив подчёркнутый зачёркнутый

Html

<b><i><u><s>жирный курсив подчёркнутый зачёркнутый</s></u></i></b>

BBCode

из-за движка rsdn не отобразить, но это калька html, где вместо <> используется []

Wiki-разметка

//**__~~жирный курсив подчёркнутый зачёркнутый~~__**//

Markdown

а хрен его знает

Дальше не буду приводить примеры, потому что мне надоело.

Списки

Списки в html чуть сложнее, чем в "упрощённых разметках".

Многоуровневые списки

Синтаксис многоуровневых списков в html сильно сложнее.

Таблицы

Таблицы в html гораздо проще для восприятия, чем в других синтаксисах и набирать их проще.

Гиперссылки

Возможности гиперссылок и установки якорей в html с атрибутом id в разы лучше любых упрощённых разметок. Это киллер фича, которая делает другие разметки попросту бесполезными. Более того, упрощённые разметки к этому времени уже совсем попутали берега со сложностью набора. Сложность заключается в том, что вместо всё тех же шаблонов <></> и <> я должен выучить ещё что-то.

Изображения

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

Видео, аудио

Html5 поддерживает файлы на локальном диске video, audio, так и вставку iframe с того же youtube.

Для пример.

С диска.

<video src="songa.mp4" height="240px" controls></video>

С youtube

<iframe src="https://www.youtube.com/embed/uQotvEi4-Zw"></iframe>

Эти конструкции очень просты, а результат великолепен. Упрощённые разметки, зачем?

Код в параграфе

Выделение кода в параграфе, тех же идентификаторов и прочего, чтобы он отличался от остального текста.

<code></code>

Код с синтаксической подсветкой

Для примера подсветка highlight.js c++.

<pre><code class="cpp"></code></pre>

Ключевая ошибка новичков в использовании html5

Собственно главная ошибка в переусложнении. Люди видят множество тегов и начинают из них генерировать франкенштейна.

Они не могут понять, что
1. используй они html5 с минимальным функционалом соответствующий упрощённым разметкам,
2. причём с точно такими же отступами для удобного просмотра как в упрощённых разметках,
3. то и простота работы была бы даже лучше, чем в упрощённых разметках за счёт однообразия.

Им надо проходить не курс как сгенерировать страничку сайта на несколько десятков мегабайт, а как создать человеко читаемые html страницы.

Тот пример, который я привёл в предыдущем комментарии в DreamWeaver выглядит так.



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



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

Почему вы лоханётесь с упрощёнными разметками

Здесь надо бы написать полноценную статью с полноценным сравнением разметок. Что пытались сделать и что в итоге получилось. Мне надоело писать, я упустил важные моменты, вроде масштабирования изображений, или якоря ссылок. Всё то, что в упрощённых разметках не просто раздражает, а вообще не даёт реализовать задумку в html5 делается элементарно, это базовый функционал.

Я даже не говорю про какое-то сложное форматирование сайтов или ещё чего. Речь именно о личных заметках. Мне тоже в своё время промыли мозги. Да я знал, что есть html4, а потом и html5, но начитался про markdown. И сам ходил такой, о ребята, смотрите, что я обнаружил, markdown, это круто и просто.

Markdown много где есть, в веб-движках, особенно его любят рубисты, вроде GitHub (Markdown) или Redmine (Markdown). Между прочим нет чёткого всемирного стандарта Markdown и его любят мешать с html, когда чего-то не хватает.

А есть ещё генераторы статических сайтов вроде Jekyll_. Типа берёшь Markdown и начинаешь фигачить заметки. Можно даже скачать специализированный редактор чисто под Markdown. Конечно, ведь написать на Markdown якобы проще, чем на html5?

Но как показывает практика, Markdown гораздо сложнее html5 в использовании и гораздо менее функционален. При этом html5 открывается во множестве браузеров и имеет стандартные валидаторы. А браузеры настолько вылизаны, что софт для упрощённых разметок с ними даже рядом не лежал.

Это получается у всех на виду html и в частности html5. На чём построен интернет с точки зрения данных? Понятно же, на html. Но люди смотрят в книгу, видят фигу. Причём я не говорю, что я умный, сразу догадался, что html5 это лучшее решение на рынке.

Нет, меня точно так же развели упрощёнными разметками, в том числе и Markdown. Может быть в каком-нибудь веб-движке для "защиты" и есть смысл в упрощённых разметках, чтобы не внедрили sql-инъекцию, или какой-нибудь html код взламывающий сайт. Но на собственных заметках, которые по сути являются готовым статическим сайтом это всё не нужно.

Да, хотя html4, а потом html5 был всегда у меня на виду, мне понадобилось лохануться и не раз чтобы понять мощь этой технологии в том числе в частном использовании. Что не нужны упрощённые разметки, и что они сложнее в использовании. Что не нужны генераторы в html, это лишнее звено, проще сразу использовать html.

Пока у людей 100 или даже 1000 заметок, они могут этого не замечать. Но практически любой заметит проблему по достижении условных 10'000 заметок. Люди начинают спрашивать, я дошёл до такого-то числа заметок или гиперссылок, почему у меня всё тормознуло в структурном редакторе вроде Zim, как это исправить. Или в Obsidian с его Markdown загружается куча времени.

Ну как это исправить? Перейти на html5. А что вы хотели? И нельзя не лохануться, потому что люди топящие за упрощённые разметки никогда не работали с 10'000 заметок. Вот у меня книга Страуструпа "Язык программирования C++" вышла на 850 html страниц. Не печатных страниц, а это просто главы.

А у меня больше сотни книг по программированию, которые я хотел прочитать и не прочитал, в основном по C++. Если создавать заметки по программам или библиотекам алгоритмов, там в одной только библиотеке может быть больше 10'000 заметок, а интересных программ и библиотек может быть сотни или тысячи. В сумме заметок может быть миллионы или десятки миллионов, но замороченные на этом люди обычно доcтигают до 100'000 .

Ну вот писали в Markdown, писали, потом поняли, что не хватает возможностей, таких как функционала или отображенияв браузере. А уже сколько всего написано. Да и теги html для поиска и замены символами подстановки или регулярными выражениями гораздо проще, чем сборная солянка упрощённых разметок вроде Markdown и прочих.

Никогда не говори никогда

Короче я не буду говорить, что никогда не используй то, и никогда не используй это. Меня уже столько раз разводили на языки программирования и языки разметок, что уже начинаешь сомневаться в собственной адекватности.

Лучший язык программирования C++.
Лучший язык разметок Html5.

Да та же самая ня, только в профиль. Что я только не изучал .NET, или Delphi, или Pascal, или QuickBasic и ещё куча других. Это всё тупое разводилово, даже C#. Кто не верит тот может одеть на себя значок "Я не лох".

Лох это судьба

https://www.youtube.com/watch?v=iTnaQd-EKbA