Переключение на Главную Страницу Страницы: 1 ОтправитьПечать
Обычная тема Конвертор rst->als (число прочтений - 2006 )
kms
1c++ power user
1c++ moderator
Отсутствует


я хочу, чтоб сюда проложили
дорогу оттуда...

Сообщений: 4632
Зарегистрирован: 19. Мая 2006
Конвертор rst->als
24. Января 2007 :: 20:04
Печать  
Пусть будет тема.
Надеюсь, коллективный разум возьмет верх над недостатком времени и пристрастием к пиву.

Сюда будем собирать мысли, как эту штуку сделать.

Мне пока, правда, кажется, что начинать нужно с декларации используемых возможностей rst.
Ну не писать же конвертор на все случаи жизни - я бы остановился на каком-то подмножестве rst.

Далее, мне представляется стандартной схема rst->xml->als.

Вроде бы не так это сложно на первый взгляд.

Для примера я смотрел xml Math и IndexedTable.
В первом методы можно вытянуть из
Код
Выбрать все
/document/section (методы)/section[N]/block_quote/field_list
 



Во втором - из
Код
Выбрать все
/document/section (методы)/section[N]/block_quote/definition_list
/document/section (методы)/section[N]/block_quote/paragraph[N]
 



Наверное, еще будет куча нюансов.
Ну, давайте, короче, делиться мыслями.
  

De quelle planète es-tu?
Наверх
 
IP записан
 
artbear
1c++ developer
1c++ moderator
Отсутствует


Эх, дайте что-нибудь новенькое
да полезное потести

Сообщений: 6303
Местоположение: Москва
Зарегистрирован: 19. Мая 2006
Пол: Мужской
Re: Конвертор rst->als
Ответ #1 - 25. Января 2007 :: 05:56
Печать  
А мне лично нравится схема обмена в разные стороны.
Т.е. как  rst->xml->als, так и  als->rst.
Потому что уже есть некий объем как файлов rst (1C++), так и очень большой набор als-файлов.
А из rst теперь легко получить chm-файлы с документацией, которые намного более удобно изучать, чем алс-файлы в Конфигураторе.
  

OpenConf developer :: http://openconf.1cpp.ru&&FormEx developer :: http://formex.dorex.ru&&1C++ active developer && tester :: www.1cpp.ru
Наверх
GTalkSkype/VoIPICQ  
IP записан
 
lustin
1c++ power user
Отсутствует


1C *.*, ROR, Java - на
этом остановимся

Сообщений: 907
Местоположение: Москва
Зарегистрирован: 20. Октября 2006
Пол: Мужской
Re: Конвертор rst->als
Ответ #2 - 25. Января 2007 :: 06:24
Печать  
Тогда такой вопрос (вроде как по теме), но не совсем:

Если мы будем иметь документацию в формате ReST:

1. Я думаю возникнет вопрос про плагин к OpenConf для ее просмотра в режиме Конфигуратора, и про скрипт поиска а-ля "Найти в синтакс-помощнике".


Чтобы иметь подобную документацию
2. Все таки нужен скрипт для OpenConf (для создания метода классса) который
      а) создаст конструкцию в модуле классса (Процедуру, Функцию Переменную)
      б) спросит все необходимые данные про класс (Описание, Пример, Типы Параметров)
      в) запишет в файл определенния классов данные в ПРАВИЛЬНОМ формате
      г) создаст (дополнит) ints файл класса
      д) перегенирирует файл подсказки tlb для Телепата

Может я не прав конечно, но для прихода к единому стандарту документирования, нужен инструмент для подобного документаривания, тогда и полезность конвертора rst <-> als вырастет в РАЗЫ
  

бизнес-процесс как техническое задание прекрасно, только у бизнеса нет процессов; у бизнеса есть желание выжить
Наверх
GTalkSkype/VoIPICQ  
IP записан
 
kms
1c++ power user
1c++ moderator
Отсутствует


я хочу, чтоб сюда проложили
дорогу оттуда...

Сообщений: 4632
Зарегистрирован: 19. Мая 2006
Re: Конвертор rst->als
Ответ #3 - 25. Января 2007 :: 08:36
Печать  
artbear писал(а) 25. Января 2007 :: 05:56:
А мне лично нравится схема обмена в разные стороны.
Т.е. как  rst->xml->als, так и  als->rst.

Почему нет, но это 2 конвертора, а не 1.
К тому же обратный, я думаю, сделать легче (степеней свободы у als меньше).
  

De quelle planète es-tu?
Наверх
 
IP записан
 
Переключение на Главную Страницу Страницы: 1
ОтправитьПечать