? Editing: Post:21.body Save Delete Cancel
Initial sync in progress...

Newest topics

Follow in NewsfeedFollowing
+ Start new topic
Loading...
stickied

Title

Body
^1 ^2 added ━ started by user_name
More topics

 

Follow in NewsfeedFollowing

Markdown: синтаксис для include?

Не совсем по теме форума, но про Markdown :)

Надо тут включать на одном сайте в Markdown-статьи другие Markdown-документы. Есть идеи, как это сделать максимально идеологически близко к Markdown? То есть это должен быть какой-то формат, похожий на читаемый текст и, желательно, в рамках привычного синтаксиса. Навскидку вижу пару вариантов:

#include "/path/file.md"

Это совсем уже для «си головного мозга» :) Но хотя бы понятен смысл.

{!/path/file.md!}

С одной стороны, с MD роднит простота (отсутствие слов), с другой — формат совсем не «MD-шный».

Думаю, идеологически это должно быть что-то в духе MD-картинок или ссылок. В MD основная идеология — дополнительная разметка поверх простого текста. То есть, по хорошему, это должна быть какая-то наглядная надстройка над логикой [текст описания](ссылка). Вот как картинки сделали добавлением восклицательного знака перед описанием.

Может, плюнуть и совместить а ля #include[опциональное описание](ссылка)? Заодно получается универсальный формат.

Или даже !include[опциональное описание](ссылка)? — почти единообразно с картинками :)

^2 ^3 balancer73 posted on Sep 02, 2018
Please sign innew comment
Sign in as...
Submit comment
You are running out of your allowed space, please contact the site's admin at unknown to raise your limit.
user_nameadded ^1 ^2
Reply
Body
balancer73on Sep 02, 2018 ^1 ^2
Reply

geekless: Как вариант, :include:. Тогда вместо кривой картинки будет кривая ссылка. :) [...]

Во! И на ЛОР также предложили:

Этот минус можно обойти если просто ссылку использовать video:

Это мысль. И валидный Markdown получается, и Fallback.

geeklesson Sep 02, 2018 ^1 ^2
Reply

Как вариант, [:include:](link). Тогда вместо кривой картинки будет кривая ссылка. :)

:include:

geeklesson Sep 02, 2018 ^1 ^2
Reply

Минус в том, как я писал выше, что при отсутствии расширенного парсинга стандартный парсер покажет всё как некорректную картинку.

Если в несовместимый парсер засовывать данные, в любом случае получится ерунда на выходе.

Насколько я помню, я исходил из того, что ![]() можно расширенно интерпретировать как внедрение любого содержимого. Просто в первую очередь требовалось внядрять именно картинки, они в спецификацию и попали. А если в приложении потребуется внядрять аудио, видео, текстовые фрагменты, iframe-ы, что угодно, то почему бы и нет. В любом случае синтаксис и семантика md всегда допиливаются под задачу, это ведь не универсальный язык описания мироздания, как XML.

balancer73on Sep 02, 2018 ^1 ^2
Reply

geekless: Я использую вариацию на тему для вставки других типов медиа: [...]

Плюс такого варианта в том, что можно использовать стандартный парсер, анализируя только alttext картинки. Я, кстати, аналогично дорабатывал ZeroTalk и ZeroBlog для вывода видео. Ставится как картинка, но смотрится расширение. Если mp4, то видео :) Минус в том, как я писал выше, что при отсутствии расширенного парсинга стандартный парсер покажет всё как некорректную картинку.

geeklesson Sep 02, 2018 ^1 ^2
Reply

balancer73: Но это валидный формат картинки :)

Валидный, но что же alttext не видно %)

geeklesson Sep 02, 2018 ^1 ^2
Reply

balancer73: В отсутствии специализированного парсера будет некорректная вставка картинки.

Ну, если настолько глобальные планы... :)

balancer73on Sep 02, 2018 ^1 ^2
Reply

geekless: Я бы использовал

Но это валидный формат картинки :) В отсутствии специализированного парсера будет некорректная вставка картинки.

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

geeklesson Sep 02, 2018 ^1 ^2
Reply

Я бы использовал ![include:](link), по аналогии.
Я использую вариацию на тему ![alttext](link) для вставки других типов медиа:

![video:](link)
![audio:](link)
gitcenteron Sep 02, 2018 ^1 ^2
Reply

<> - это типа вставить. Из раздела "юмор".

balancer73on Sep 02, 2018 ^1 ^2
Reply

Ещё с LOR: (!/path/file.md)

В этом что-то есть. Хотя больше по логике смахивает на картинку без описания :)

balancer73on Sep 02, 2018 ^1 ^2
Reply

gitcenter: <>description

Как-то не очень логично, ИМХО.

В LOR ещё предлагают вариант {{/path/file.md}} — ИМХО, совсем не MD-стиль.

gitcenteron Sep 02, 2018 ^1 ^2
Reply

<>[description](link)

This page is a snapshot of ZeroNet. Start your own ZeroNet for complete experience. Learn More