Переключение на Главную Страницу Страницы: 1 2 3 [4]  ОтправитьПечать
Очень популярная тема (более 25 ответов) XML и ALS–документация по классам (число прочтений - 11118 )
JohnyDeath
1c++ power user
1c++ donor
Отсутствует



Сообщений: 3050
Местоположение: Волгоград
Зарегистрирован: 19. Мая 2006
Пол: Мужской
Re: XML и ALS–документация по классам
Ответ #45 - 17. Октября 2008 :: 12:27
Печать  
Phoenix писал(а) 17. Октября 2008 :: 12:14:
insertTag - вставляет тэг документатора, что-то типа шаблона.
для формирования документации запускаешь generateDoc... в тексте модуля, по которому хочешь составить документацию.
prm - пример использования тегом для генерации als
ерт - пример частично задокументированного модуля.
более подробно информацию можно найти в сети, опять же сейчас пока не поддерживается тег "---" и "===".
вместо двух пробелов для переноса нужно ставить "&&", опять же это написано в скрипте.

извиняюсь, сначала не так запускал - вообще всё молчало.
Открыл твой КОП, натравил на него generateDocAll, вывалилась ошибка :
(я что-то вообще не догоняю. Номер строки в скрипте? ТАм же только      "{" стоит...)
  

1_005.jpg ( 68 KB | Загрузки )
1_005.jpg
Наверх
 
IP записан
 
Phoenix
Senior Member
****
Отсутствует


itpath.ru

Сообщений: 398
Местоположение: Москва
Зарегистрирован: 15. Июня 2006
Пол: Мужской
Re: XML и ALS–документация по классам
Ответ #46 - 17. Октября 2008 :: 12:36
Печать  
в каталоге БД есть папка: Documentation\txt и Documentation\html
если нет - создай, скрипт пока пути не создает.

+ в скрипте написано:
Цитата:
     
Для работы необходимо чтобы в каталоге ИБ были папки:
           IBDir +"Documentation\txt\";
           IBDir +"Documentation\html\";

  

Лень двигатель прогресса.&&http://www.itpath.ru&&;
Наверх
IP записан
 
JohnyDeath
1c++ power user
1c++ donor
Отсутствует



Сообщений: 3050
Местоположение: Волгоград
Зарегистрирован: 19. Мая 2006
Пол: Мужской
Re: XML и ALS–документация по классам
Ответ #47 - 17. Октября 2008 :: 12:41
Печать  
Phoenix писал(а) 17. Октября 2008 :: 12:36:
в каталоге БД есть папка: Documentation\txt и Documentation\html
если нет - создай, скрипт пока пути не создает.

+ в скрипте написано:
Цитата:
     
Для работы необходимо чтобы в каталоге ИБ были папки:
           IBDir +"Documentation\txt\";
           IBDir +"Documentation\html\";


Не вижу. Честно, в скрипте нет никаких комментариев, кроме начального заголовка об авторстве и краткого описания назначения.
txt создал, потом вывалилась новая ошибка: на строку 288 поз. 1. Описание: Файл не найден.
  
Наверх
 
IP записан
 
Phoenix
Senior Member
****
Отсутствует


itpath.ru

Сообщений: 398
Местоположение: Москва
Зарегистрирован: 15. Июня 2006
Пол: Мужской
Re: XML и ALS–документация по классам
Ответ #48 - 17. Октября 2008 :: 12:50
Печать  
рабочий день окончен, пошел домой, буду доступен вечером, ближе к вечеру.
должны быть созданы оба каталога. это обязательно
markdown.pl должен быть виден скрипту.
в остальном все должно рабоать. чуть что - отладчик Улыбка
результат мне - подправлю.
  

Лень двигатель прогресса.&&http://www.itpath.ru&&;
Наверх
IP записан
 
JohnyDeath
1c++ power user
1c++ donor
Отсутствует



Сообщений: 3050
Местоположение: Волгоград
Зарегистрирован: 19. Мая 2006
Пол: Мужской
Re: XML и ALS–документация по классам
Ответ #49 - 17. Октября 2008 :: 12:58
Печать  
Phoenix писал(а) 17. Октября 2008 :: 12:50:
рабочий день окончен, пошел домой, буду доступен вечером, ближе к вечеру.
должны быть созданы оба каталога. это обязательно
markdown.pl должен быть виден скрипту.
в остальном все должно рабоать. чуть что - отладчик Улыбка
результат мне - подправлю.

Все условия выполнены. Отладчик из wscite?
Спасибо и на этом  Подмигивание ( а в аське, указанной в скрипте,  вечером к тебе можно будет пристать?
  
Наверх
 
IP записан
 
Phoenix
Senior Member
****
Отсутствует


itpath.ru

Сообщений: 398
Местоположение: Москва
Зарегистрирован: 15. Июня 2006
Пол: Мужской
Re: XML и ALS–документация по классам
Ответ #50 - 21. Октября 2008 :: 08:22
Печать  
Цитата:
Отладчик из wscite?
Спасибо и на этом  Подмигивание ( а в аське, указанной в скрипте,  вечером к тебе можно будет пристать?

Отладчик - а что это? Улыбка
мне хватает вывода в окно сообщений.
в асю можно стучаться всегда, если занят - сообщу.

в результате разобрался, все работает?
  

Лень двигатель прогресса.&&http://www.itpath.ru&&;
Наверх
IP записан
 
JohnyDeath
1c++ power user
1c++ donor
Отсутствует



Сообщений: 3050
Местоположение: Волгоград
Зарегистрирован: 19. Мая 2006
Пол: Мужской
Re: XML и ALS–документация по классам
Ответ #51 - 21. Октября 2008 :: 14:01
Печать  
Phoenix писал(а) 21. Октября 2008 :: 08:22:
в результате разобрался, все работает?

Нет, пона не получается. (я вообще туп в скриптописании особенно под опенконф) Генерится только txt.
  
Наверх
 
IP записан
 
Phoenix
Senior Member
****
Отсутствует


itpath.ru

Сообщений: 398
Местоположение: Москва
Зарегистрирован: 15. Июня 2006
Пол: Мужской
Re: XML и ALS–документация по классам
Ответ #52 - 21. Октября 2008 :: 19:08
Печать  
markdown.pl где лежит?
положи его в системную шару -все заработает.
как вариант положи туда же где скрипт документации
  

Лень двигатель прогресса.&&http://www.itpath.ru&&;
Наверх
IP записан
 
Переключение на Главную Страницу Страницы: 1 2 3 [4] 
ОтправитьПечать