Справка Far в легко читаемом формате (PDF, HTML и т.п.)

Хотите говорить о Far и не знаете, куда обратиться?
User avatar
NightRoman
Posts: 6184
Joined: Fri 18 Aug, 2006 13:52
Location: Cambridge, UK
Has thanked: 32 times
Been thanked: 62 times
Contact:

Re: Справка Far в легко читаемом формате (PDF, HTML и т.п.)

Post by NightRoman »

Latest post of the previous page:

John Doe wrote:Конвертация это не тупиковый путь, а промежуточный этап.
Никто не мешает научить фар отображать md в последствии
А md не идеал, по-моему. Это кандидат, да. Но если думать о поддерживаемом в будущем формате, то надо куда большую работу по оценке кандидатов и выбору провести.
User avatar
John Doe
Бюрократ
Posts: 13851
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 73 times
Been thanked: 428 times
Contact:

Re: Справка Far в легко читаемом формате (PDF, HTML и т.п.)

Post by John Doe »

NightRoman wrote:Если пока нет ресурсов и желающих, то ничего не делать. Не исключено, что они появятся. Или лучшие идеи появятся.
Вот уж врядли.
NightRoman wrote:Но если думать о поддерживаемом в будущем формате, то надо куда большую работу по оценке кандидатов и выбору провести.
Может поделитесь хотя бы начальными соображениями?
User avatar
NightRoman
Posts: 6184
Joined: Fri 18 Aug, 2006 13:52
Location: Cambridge, UK
Has thanked: 32 times
Been thanked: 62 times
Contact:

Re: Справка Far в легко читаемом формате (PDF, HTML и т.п.)

Post by NightRoman »

John Doe wrote:
NightRoman wrote:Если пока нет ресурсов и желающих, то ничего не делать. Не исключено, что они появятся. Или лучшие идеи появятся.
Вот уж врядли.
Я уже проводил аналогию с макроязыком. И желающие, и ресурсы нашлись.
поделитесь хотя бы начальными соображениями?
Вики формат, наверное, надо учесть тоже для начала. Но я его и инструменты для него детально не изучал, ничего более сказать не могу.
User avatar
NightRoman
Posts: 6184
Joined: Fri 18 Aug, 2006 13:52
Location: Cambridge, UK
Has thanked: 32 times
Been thanked: 62 times
Contact:

Re: Справка Far в легко читаемом формате (PDF, HTML и т.п.)

Post by NightRoman »

В идеале должна быть википодобная система, которая была бы полезна и не только для Фара. То есть может легко писаться в файлах и рендериться на лету в Фаре, но в любой момент может быть сконвертирована в набор HTML, PDF, CHM и т.п. Если планировать ее таким образом, то стимулов создать такую систему *разработки и показа* документации может быть больше. И пользы от нее тоже.
Last edited by NightRoman on Tue 16 Apr, 2013 12:34, edited 1 time in total.
User avatar
John Doe
Бюрократ
Posts: 13851
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 73 times
Been thanked: 428 times
Contact:

Re: Справка Far в легко читаемом формате (PDF, HTML и т.п.)

Post by John Doe »

NightRoman wrote:Я уже проводил аналогию с макроязыком. И желающие, и ресурсы нашлись.
Плохая аналогия.
В макроязыке мы получили огромный прирост функциональности. И база (LuaFAR) к тому времени уже существовала несколько лет.
А что мы получим в хелпе?

Имхо нечего там особо развивать.
Формат, пригодный для публикации на сайте - это уже большое достижение. Он по определению (полу)автоматически пригоден для chm и pdf.
NightRoman wrote:
поделитесь хотя бы начальными соображениями?
Вики формат, наверное, надо учесть тоже для начала.
Зачем он сдался?
Интересуют реальные практические соображения.
Давайте начнём с того, чего вам не хватило в md?
Т.е. что искать в альтернативах?
User avatar
NightRoman
Posts: 6184
Joined: Fri 18 Aug, 2006 13:52
Location: Cambridge, UK
Has thanked: 32 times
Been thanked: 62 times
Contact:

Re: Справка Far в легко читаемом формате (PDF, HTML и т.п.)

Post by NightRoman »

Я все сказал, думаю. Спорить мне вроде не о чем, и в данный момент я немного занят.
User avatar
John Doe
Бюрократ
Posts: 13851
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 73 times
Been thanked: 428 times
Contact:

Re: Справка Far в легко читаемом формате (PDF, HTML и т.п.)

Post by John Doe »

У нас же не видеочат, ответите когда пожелаете.
User avatar
NightRoman
Posts: 6184
Joined: Fri 18 Aug, 2006 13:52
Location: Cambridge, UK
Has thanked: 32 times
Been thanked: 62 times
Contact:

Re: Справка Far в легко читаемом формате (PDF, HTML и т.п.)

Post by NightRoman »

John Doe wrote:Давайте начнём с того, чего вам не хватило в md? Т.е. что искать в альтернативах?
Это хороший вопрос.
-- Наличие спецификации формата. В мд есть только неформальное описание от автора. В простых случаях хватает, в сложных разные тулзы трактуют всяк по своему, ибо строгости нет.
-- Наличие инструментов. Каких? Разных. Не буду развивать. Для мд более-менее интрументы есть, тут дела неплохи.
-- Документация в нескольких файлах. Мд не для этого, изначально он заточен под один документ.
-- Перекрестные ссылки. Мд тоже не очень хорош для этого. Диалекты мд это реализуют, но это неродные прикрутки.
-- Таблицы в мд - просто смех. Лучше уж встроенный ХТМЛ пользовать. Но эта фича (встроенный ХТМЛ) в мд, кстати, не от хорошей жизни, а от плохой.

Ну это так, что первое в голову пришло.
User avatar
John Doe
Бюрократ
Posts: 13851
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 73 times
Been thanked: 428 times
Contact:

Re: Справка Far в легко читаемом формате (PDF, HTML и т.п.)

Post by John Doe »

Неоднозначности трактовки, вытекающие из отсутствия формальной спецификации это не очень хорошо, но для наших целей несущественно.
По настоящему этого можно избежать только в основанных на xml форматах, а оно нам надо?
Сложные таблицы особо не нужны. 2 столбца без разделителя - с головой.
А вот документация в нескольких файлах, и перекрёстные ссылки - это очень важно (но вы пишите, что диалекты умеют?)
User avatar
NightRoman
Posts: 6184
Joined: Fri 18 Aug, 2006 13:52
Location: Cambridge, UK
Has thanked: 32 times
Been thanked: 62 times
Contact:

Re: Справка Far в легко читаемом формате (PDF, HTML и т.п.)

Post by NightRoman »

John Doe wrote:Сложные таблицы особо не нужны. 2 столбца без разделителя - с головой.
Там даже это проблема, если в колонках не одно-два слова, а текст, абзац, а то и несколько (даже вообще не уверен, что это возможно).
User avatar
NightRoman
Posts: 6184
Joined: Fri 18 Aug, 2006 13:52
Location: Cambridge, UK
Has thanked: 32 times
Been thanked: 62 times
Contact:

Re: Справка Far в легко читаемом формате (PDF, HTML и т.п.)

Post by NightRoman »

Ни XML, ни HTML, как основа документации я бы не выбирал. МД - неплохой кандидат. Но другие форматы я бы тоже изучил прежде чем закладываться на мд надолго. Надо исследовать эту область и выбирать предположительно оптимальное что-то. Но идеального ничего не будет, надо понимать сразу. Поэтому будет очень полезно подумать вначале, найти и взвесить плюсы и минусы, а уж потом вкладываться.
User avatar
John Doe
Бюрократ
Posts: 13851
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 73 times
Been thanked: 428 times
Contact:

Re: Справка Far в легко читаемом формате (PDF, HTML и т.п.)

Post by John Doe »

Предлагается исходить из практики, т.е. насколько полноценно можно представить в md имеющуюся у нас справку, в первую очередь справку фара.

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

P.S.
Да, можно рассматривать варианты, взвешивать плюсы/минусы, выбрать что-то другое...
Но конвертера-то к нему нет, и писать некому
professor_k
Posts: 7
Joined: Mon 25 Mar, 2013 19:47

Re: Справка Far в легко читаемом формате (PDF, HTML и т.п.)

Post by professor_k »

Если учесть проблемы с .net-ом на сервере, конвертера считай нет. А если учесть небольшую его сложность — то проблем переписать его с нуля под любую исходную разметку тоже особо нет. А поэтому можно посмотреть и на альтернативы:
http://en.wikipedia.org/wiki/Lightweigh ... p_language
http://stackoverflow.com/questions/6592 ... own-and-re

Насколько я понял, все легкие разметки — те же яйца, только в профиль. И всюду те же проблемы с таблицами. Итого — можно продолжать заниматься md, а можно например взять reStructuredText, с четкой спецификацией и более-менее съедобными таблицами.
hellboy
Posts: 26
Joined: Sun 19 Apr, 2009 11:20

Re: Справка Far в легко читаемом формате (PDF, HTML и т.п.)

Post by hellboy »

а почему не рассматривается AsciiDoc?
User avatar
John Doe
Бюрократ
Posts: 13851
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 73 times
Been thanked: 428 times
Contact:

Справка Far в легко читаемом формате (PDF, HTML и т.п.)

Post by John Doe »

https://documentation.help/Far-Manager-ru/
Кто-нибудь знает источник этого?
https://t.me/FarManager — Telegram чат
Post Reply

Return to “Обсуждение Far Manager”