Size: a a a

technicalwriters

2020 December 14

BF

Bobba Fett in technicalwriters
Nick Volynkin
Чтобы у вас хорошо работал дифф по предложениям, пишите предложения с новой строки. А то и сложные предложения разбивайте по запятым. :)
источник

BF

Bobba Fett in technicalwriters
Однако это не отменяет удобство такой фичи прямо встроенной в дифф вьюер, возвращаясь к теме писательской интеграции в ИДЕ и редакторах
источник

NV

Nick Volynkin in technicalwriters
Ivan Kochurkin
Наверняка можно написать pandoc-фильтр так, что менялась длина строки, чтобы ссылки все были на новой строке.
Просто максимальную длину строки задать можно, но он всё равно будет переносить по словам, а не по ссылкам или предложениям. Но я давно не смотрел на пандок, может там и умные переносы появились.
источник

IK

Ivan Kochurkin in technicalwriters
Там же есть фильтры, с помощью которых можно генерировать вообще произвольный текст? Правда я еще не пробовал.
источник

IK

Ivan Kochurkin in technicalwriters
Можно даже просто брать AST и перегонять его сразу в текст нужного формата, без его трансформации (но этот подход менее гибкий).
источник

NV

Nick Volynkin in technicalwriters
Ivan Kochurkin
Там же есть фильтры, с помощью которых можно генерировать вообще произвольный текст? Правда я еще не пробовал.
Есть фильтры на Lua и Haskell. Или можно похачить прямо writer в нужный формат. Но тогда только Haskell, я его боюсь. :)
источник

NV

Nick Volynkin in technicalwriters
Я однажды пришёл в pandoc с проблемой, что при конвертации в rST  отступы получаются разные: где два пробела, где три. Предложил сделать везде четыре, потому что это тупо удобно редактировать, все редакторы умеют по нажатию на Tab добивать отступ до числа пробелов, кратного четырём. Но они сделали три. 😢
источник

IK

Ivan Kochurkin in technicalwriters
Там json генерируется, соответственно фильтр можно писать на любом языке.
источник

NV

Nick Volynkin in technicalwriters
Да? В последний раз, когда я смотрел на AST, там было что-то хаскелеобразное.
источник

NV

Nick Volynkin in technicalwriters
Хтоническое и со щупальцами )
источник

СФ

Семён Факторович... in technicalwriters
Nick Volynkin
Да? В последний раз, когда я смотрел на AST, там было что-то хаскелеобразное.
там изкоробочные биндинги на питоне, хаскеле и чем-то еще, забыл
источник

NV

Nick Volynkin in technicalwriters
Семён Факторович
там изкоробочные биндинги на питоне, хаскеле и чем-то еще, забыл
на Python вроде
источник

СФ

Семён Факторович... in technicalwriters
Nick Volynkin
на Python вроде
на питоне еще, кажется:)
источник

IK

Ivan Kochurkin in technicalwriters
На чем угодно можно, просто структуру классов еще придется описывать: https://pandoc.org/filters.html#technical-details-of-json-filters

A JSON filter is any program which can consume and produce a valid pandoc JSON document representation. This section describes the technical details surrounding the invocation of filters.
источник

IK

Ivan Kochurkin in technicalwriters
Раз уж заговорили о pandoc, то вот что мне в нем не понравилось:

1. Не дампит локацию AST узлов на текст (насколько понимаю, будет реализовано в следующей версии https://github.com/jgm/pandoc/issues/4565)
2. Не парсит HTML код внутри MD узлов - для этого нужно писать дополнительный парсер, который будет учитывать смесь из HTML и MD блоков.
источник

ET

Eduard Tibet in technicalwriters
Ivan Kochurkin
Раз уж заговорили о pandoc, то вот что мне в нем не понравилось:

1. Не дампит локацию AST узлов на текст (насколько понимаю, будет реализовано в следующей версии https://github.com/jgm/pandoc/issues/4565)
2. Не парсит HTML код внутри MD узлов - для этого нужно писать дополнительный парсер, который будет учитывать смесь из HTML и MD блоков.
Все это мне напоминает изобретение колеса :) Которое изначально было внедрено в xml-мире  в виде т.н. namespaces. В свое время Norman Walsh писал о том, что рано радуетесь текстовым форматам, чуваки. Мы все еще увидим попытки вставить инородные структуры текста в друг друга и попытки придумать namespaces внутри text-based markups (у него конкретно шла речь про json).
источник

IK

Ivan Kochurkin in technicalwriters
Т.е. по вашему правильней было бы использовать xml для текстов?
источник

ET

Eduard Tibet in technicalwriters
Ivan Kochurkin
Т.е. по вашему правильней было бы использовать xml для текстов?
Я всего лишь запостил то, что запостил :) Каждый использует то, что необходимо в каждой конкретной ситуации :)
источник

IK

Ivan Kochurkin in technicalwriters
Мне не кажется это колесом - я бы плевался, если бы пришлось текст набирать в чем-то xml-подобным, а markdown (или другой подобный формат) освоить намного легче, он максимально приближен к тексту. Это как Питон в мире разработке :)
источник

ET

Eduard Tibet in technicalwriters
Ivan Kochurkin
Мне не кажется это колесом - я бы плевался, если бы пришлось текст набирать в чем-то xml-подобным, а markdown (или другой подобный формат) освоить намного легче, он максимально приближен к тексту. Это как Питон в мире разработке :)
xml в документации не предназначен для использовать в голом (plain-text) редакторе. Это не его стихия.
источник