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


I wanted to cry, but the
tears wouldn't come

Сообщений: 2712
Зарегистрирован: 19. Мая 2006
Пол: Мужской
Re: Сборка документации
Ответ #15 - 19. Декабря 2007 :: 06:31
Печать  
fez писал(а) 19. Декабря 2007 :: 06:27:
Кстати, где-то Артур интересовался, как там номера строк считать. По ходу дела он виндовый \n\r за две строки считает. Так что надо делить на два.

И вообще, он ошибки выкладывает еще и непосредственно в документацию. Так что вообще все примитивно.
  
Наверх
www  
IP записан
 
fez
Forum Administrator
1c++ power user
Отсутствует


I wanted to cry, but the
tears wouldn't come

Сообщений: 2712
Зарегистрирован: 19. Мая 2006
Пол: Мужской
Re: Сборка документации
Ответ #16 - 19. Декабря 2007 :: 06:38
Печать  
Раз уж мы заговорили про extobjs. Артур, это тебе, как мне кажется.
Там в описании класса БуферОбмена есть якорь "Получить". Подстава в том, что якорь с таким именем уже есть на этой странице, и оно закономерно на это дело ругается.
  
Наверх
www  
IP записан
 
artbear
1c++ developer
1c++ moderator
Отсутствует


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

Сообщений: 6303
Местоположение: Москва
Зарегистрирован: 19. Мая 2006
Пол: Мужской
Re: Сборка документации
Ответ #17 - 19. Декабря 2007 :: 07:32
Печать  
Лады, все подсказки принял к сведению.
Постараюсь сегодня поправить.
ЗЫ если сегодня не успею, значит, до след.недели, т.к. завтра очередной оффлайн до понедельника Улыбка
  

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


I wanted to cry, but the
tears wouldn't come

Сообщений: 2712
Зарегистрирован: 19. Мая 2006
Пол: Мужской
Re: Сборка документации
Ответ #18 - 01. Января 2008 :: 21:54
Печать  
Поправил отступы в Hooker.txt
  
Наверх
www  
IP записан
 
kms
1c++ power user
1c++ moderator
Отсутствует


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

Сообщений: 4632
Зарегистрирован: 19. Мая 2006
Re: Сборка документации
Ответ #19 - 16. Марта 2008 :: 12:38
Печать  
artbear

Артур, у меня тут проблемка со сборкой документации в HTML.


1>------ Build started: Project: Documents, Configuration: HTML Win32 ------
1>Компиляция DocumentsRules.html
1>Компиляция chmcreate.html
1>Компиляция TurboBL.html
1>Компиляция TableField.html
1>Компиляция SettingsManager.html
1>Компиляция oledb.html
1>Компиляция ODBC.html
1>Компиляция Math.html
1>Компиляция LogDataProvider.html
1>Компиляция Informer.html
1>y:\1\Documents\Informer.txt:251: (WARNING/2) Definition list ends without a blank line; unexpected unindent.
1>y:\1\Documents\Informer.txt:259: (WARNING/2) Definition list ends without a blank line; unexpected unindent.
1>y:\1\Documents\Informer.txt:267: (WARNING/2) Definition list ends without a blank line; unexpected unindent.
1>y:\1\Documents\Informer.txt:275: (WARNING/2) Definition list ends without a blank line; unexpected unindent.
1>y:\1\Documents\Informer.txt:283: (WARNING/2) Definition list ends without a blank line; unexpected unindent.
1>y:\1\Documents\Informer.txt:302: (WARNING/2) Definition list ends without a blank line; unexpected unindent.
1>y:\1\Documents\Informer.txt:311: (WARNING/2) Definition list ends without a blank line; unexpected unindent.
1>y:\1\Documents\Informer.txt:343: (WARNING/2) Block quote ends without a blank line; unexpected unindent.
1>y:\1\Documents\Informer.txt:357: (WARNING/2) Block quote ends without a blank line; unexpected unindent.
1>Компиляция IndexedTable.html
1>Компиляция Hooker.html
1>Компиляция guid.html
1>Компиляция extobjs.html
1>y:\1\Documents\extobjs.txt:2393: (WARNING/2) Duplicate explicit target name: "\u043f\u043e\u043b\u0443\u0447\u0438\u0442\u044c".
1>Компиляция DataProviderSDK.html
1>Компиляция classes.html
1>Компиляция BinaryData.html
1>Компиляция ActiveX.html
1>Компиляция 1cpp.html
1>Build Time 0:15
1>Documents - 0 error(s), 0 warning(s)
========== Build: 1 succeeded, 0 failed, 0 up-to-date, 0 skipped ==========


У тебя вроде были планы поправить?
Если проблемы с поиском места, то просто открываешь собранный html и то, что там в рамках красным цветом, правишь в оригинале.
  

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


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

Сообщений: 4632
Зарегистрирован: 19. Мая 2006
Re: Сборка документации
Ответ #20 - 16. Марта 2008 :: 12:44
Печать  
fez писал(а) 10. Декабря 2007 :: 11:24:
Сегодня обнаружил на сборочном компьютере ошибку hhc.exe.
Запустив ночную сборку ручками, наблюдал множественные предупреждения и ошибки при сборке документации: как html, так и chm. Однако при этом все собралось.
Думаю, что разработчикам имеет смысл присмотреться к данным ошибкам/предупреждениям, и решить: стоит ли их исправить или нет.

С chm что-то мне вообще непонятно, как собирать... (у меня что-то при сборке проблема на проблеме).
Я думаю, разбираться с chm - это наверное целая отдельная тема будет.
Может быть и правда, ежедневную сборку chm пока отключить, чтобы хотя бы dll/html гарантированно собирались?
  

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


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

Сообщений: 6303
Местоположение: Москва
Зарегистрирован: 19. Мая 2006
Пол: Мужской
Re: Сборка документации
Ответ #21 - 16. Марта 2008 :: 12:49
Печать  
kms писал(а) 16. Марта 2008 :: 12:44:
С chm что-то мне вообще непонятно, как собирать... (у меня что-то при сборке проблема на проблеме).

Какие версии Питона и docutils юзаешь ?
По своей доке обещаю посмотреть, но уже не сегодня Улыбка
  

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


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

Сообщений: 4632
Зарегистрирован: 19. Мая 2006
Re: Сборка документации
Ответ #22 - 16. Марта 2008 :: 12:55
Печать  
artbear писал(а) 16. Марта 2008 :: 12:49:
Какие версии Питона и docutils юзаешь ?

docutils-0.4
Python 2.4.3
hhc 4.74.8702.0

да вроде собиралось с ними раньше, а сейчас чего-то как-то совсем тяжко
из-под msdev вчера вообще cscript в av вылетал при попытке сборки chm

Поэтому, думаю, и у Федора те же траблы по ночам, т.е. что-то надо тут думать будет.
  

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


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

Сообщений: 6303
Местоположение: Москва
Зарегистрирован: 19. Мая 2006
Пол: Мужской
Re: Сборка документации
Ответ #23 - 16. Марта 2008 :: 12:58
Печать  
fez писал(а) 19. Декабря 2007 :: 06:38:
Раз уж мы заговорили про extobjs. Артур, это тебе, как мне кажется.
Там в описании класса БуферОбмена есть якорь "Получить". Подстава в том, что якорь с таким именем уже есть на этой странице, и оно закономерно на это дело ругается.

Исправил.
  

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


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

Сообщений: 6303
Местоположение: Москва
Зарегистрирован: 19. Мая 2006
Пол: Мужской
Re: Сборка документации
Ответ #24 - 16. Марта 2008 :: 13:02
Печать  
kms писал(а) 16. Марта 2008 :: 12:55:
artbear писал(а) 16. Марта 2008 :: 12:49:
Какие версии Питона и docutils юзаешь ?

docutils-0.4
Python 2.4.3
hhc 4.74.8702.0

Совпадает почти все, только у меня Питон 2.4.4

По cscript, возможно, есть смысл обновить WSH или просто выполнить апдейт системы, именно апдейт Винды, а не ее полную установку.
С Опенконфом и его скриптами/плагинами проблем не замечал? Процесс 1с после выхода из Конфигуратора не зависает случайно?
  

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


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

Сообщений: 6303
Местоположение: Москва
Зарегистрирован: 19. Мая 2006
Пол: Мужской
Re: Сборка документации
Ответ #25 - 16. Марта 2008 :: 13:10
Печать  
kms писал(а) 16. Марта 2008 :: 12:38:
Артур, у меня тут проблемка со сборкой документации в HTML.


1>Компиляция Informer.html
1>y:\1\Documents\Informer.txt:251: (WARNING/2) Definition list ends without a blank line; unexpected unindent.
1>y:\1\Documents\Informer.txt:259: (WARNING/2) Definition list ends without a blank line; unexpected unindent.
1>y:\1\Documents\Informer.txt:267: (WARNING/2) Definition list ends without a blank line; unexpected unindent.
1>y:\1\Documents\Informer.txt:275: (WARNING/2) Definition list ends without a blank line; unexpected unindent.
1>y:\1\Documents\Informer.txt:283: (WARNING/2) Definition list ends without a blank line; unexpected unindent.
1>y:\1\Documents\Informer.txt:302: (WARNING/2) Definition list ends without a blank line; unexpected unindent.
1>y:\1\Documents\Informer.txt:311: (WARNING/2) Definition list ends without a blank line; unexpected unindent.
1>y:\1\Documents\Informer.txt:343: (WARNING/2) Block quote ends without a blank line; unexpected unindent.
1>y:\1\Documents\Informer.txt:357: (WARNING/2) Block quote ends without a blank line; unexpected unindent.


У тебя вроде были планы поправить?
Если проблемы с поиском места, то просто открываешь собранный html и то, что там в рамках красным цветом, правишь в оригинале.

Не подтверждаю, у меня все ОК, подобных сообщений нет Улыбка
Возможно, Федор все-таки поправил в свое время, не дождавшись от меня Улыбка ?
Я юзаю доку из ствола, т.е. 2.5
  

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


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

Сообщений: 4632
Зарегистрирован: 19. Мая 2006
Re: Сборка документации
Ответ #26 - 16. Марта 2008 :: 13:23
Печать  
artbear писал(а) 16. Марта 2008 :: 13:02:
Совпадает почти все, только у меня Питон 2.4.4

По cscript, возможно, есть смысл обновить WSH или просто выполнить апдейт системы, именно апдейт Винды, а не ее полную установку.
С Опенконфом и его скриптами/плагинами проблем не замечал? Процесс 1с после выхода из Конфигуратора не зависает случайно?

С опенконфом нет, конечно проблем, я думаю не в cscript дело.
Ну, пока помолчу, потому что не разбирался, отложил пока chm.
У тебя нормально все chm собираются?
  

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


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

Сообщений: 4632
Зарегистрирован: 19. Мая 2006
Re: Сборка документации
Ответ #27 - 16. Марта 2008 :: 13:25
Печать  
artbear писал(а) 16. Марта 2008 :: 13:10:
Не подтверждаю, у меня все ОК, подобных сообщений нет Улыбка
Возможно, Федор все-таки поправил в свое время, не дождавшись от меня Улыбка ?
Я юзаю доку из ствола, т.е. 2.5

И правда, на сайте в разделе документация все путем.
Интересно, а у меня вот так собирается, хотя ведь тоже из ствола, тот же файл. Озадачен
В xml это я переименовал, чтобы сюда прицепить, это обычный html.
  

Informer.xml ( 29 KB | Загрузки )

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


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

Сообщений: 6303
Местоположение: Москва
Зарегистрирован: 19. Мая 2006
Пол: Мужской
Re: Сборка документации
Ответ #28 - 16. Марта 2008 :: 13:28
Печать  
Возможно, дело в том, что я никогда не собираю из Студии, а только из ком.строки Улыбка
  

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


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

Сообщений: 4632
Зарегистрирован: 19. Мая 2006
Re: Сборка документации
Ответ #29 - 16. Марта 2008 :: 13:50
Печать  
artbear писал(а) 16. Марта 2008 :: 13:28:
Возможно, дело в том, что я никогда не собираю из Студии, а только из ком.строки Улыбка

Да, точно.

Если вот так изменить скрипт, то будет так же, как в студии:
Код
Выбрать все
rem rst2html.py --output-encoding CP1251 --tab-width 4 --date --time --generator "%1" "%~dp1html\%~n1.html"
rst2html.py --output-encoding CP1251 "%1" "%~dp1html\%~n1.html"
 



Видимо, чем-то ей табы не нравятся.
  

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