Онлайн версия документации

Разработка Far.
User avatar
techie
Posts: 712
Joined: Mon 03 Oct, 2005 22:42
Has thanked: 22 times
Been thanked: 2 times

Онлайн версия документации

Postby techie » Tue 21 Oct, 2014 06:29

HaRT wrote:
techie wrote:Нужна веб версия документации. Оффлайн - это хорошо, но бравзер с гуглом уже удобнее.

Наслаждайтесь. Дальнейшие претензии — к Гуглу. :evil:

Есть план:
  • Найти место где это будет лежать - Исходники сайта
  • Переместить /trunk/unicode_far/*.hlf.m4 в /trunk/unicode_far/help/*.hlf
  • Написать парсер для .hlf формата на Python (чтобы получить полную дата модель для трансформации)
  • Написать конвертер из .hlf модели в гипертекст (и в формат Far заодно)
  • Обратить внимание на Sphinx - посмотреть исходную дата модель после ReStructureText - doctree (можно ли перегнать в неё)
  • Добиться рендеринга текста хоть в каком-нибудь HTML формате
  • Забахать темплейт с fixed-size шрифтами, чтобы воспроизвести окно F1

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

Эта ссылка на формат *.hlf актуальная и полная?

User avatar
John Doe
Бюрократ
Posts: 11048
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 10 times
Been thanked: 63 times

Онлайн версия документации

Postby John Doe » Tue 21 Oct, 2014 06:50

>Добиться рендеринга текста хоть в каком-нибудь HTML формате
"Хоть в каком-то" можно хоть сейчас.

>Написать конвертер из .hlf модели в гипертекст (и в формат Far заодно)
Жаль некому.
Обсуждение тут: Встроенная справка в удобном формате

User avatar
HaRT
Moderator
Posts: 7955
Joined: Tue 30 Aug, 2005 17:21
Location: Санкт-Петербург
Has thanked: 66 times
Been thanked: 97 times

Онлайн версия документации

Postby HaRT » Tue 21 Oct, 2014 11:35

techie wrote:Source of the post на Python
techie wrote:Source of the post на Sphinx
techie wrote:Source of the post doctree
Инструменты надо выбирать под требования (requirements), а требования-то и не формализованы.
Кроме того, обязательно надо прежде изучить имеющийся опыт: хоть применение того же Markdown — пользуйтесь поиском по форуму.
Фар есть инструмент, а не нянька. © 2009 DrKnS

User avatar
techie
Posts: 712
Joined: Mon 03 Oct, 2005 22:42
Has thanked: 22 times
Been thanked: 2 times

Онлайн версия документации

Postby techie » Tue 04 Nov, 2014 20:06

Требования к хелпу Far:
- удобно линковать страницы помощи без HTML тэгов
- держать хелп в памяти в компактном формате
- удобно работать с помощью без мыши

Требования к онлайн формату:
- быть онлайн

Насчёт изучения опыта - надо суммировать. Появляются новые технологии, которые *возможно* решают предыдущие проблемы, но о проблемах никто не помнит, а объём информации на форуме уже неосилить.

User avatar
techie
Posts: 712
Joined: Mon 03 Oct, 2005 22:42
Has thanked: 22 times
Been thanked: 2 times

Онлайн версия документации

Postby techie » Tue 04 Nov, 2014 20:15

Отфильтрованный список проблем:

John Doe @ Встроенная справка в удобном формате (только третий спойлер актуален)


Return to “Development”

Who is online

Users browsing this forum: No registered users and 1 guest