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


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

Сообщений: 6303
Местоположение: Москва
Зарегистрирован: 19. Мая 2006
Пол: Мужской
Re: Сборка документации
Ответ #30 - 16. Марта 2008 :: 13:54
Печать  
fez писал(а) 16. Декабря 2007 :: 06:22:
На отступы он жалуется. В основной своей массе.
Я так думаю, что ему плохеет от смеси табуляций и пробелов. Это стандартная питоновая фишка: если начал делать отступы пробелами - делай во всем файле пробелами. Если начал табуляцией - нужно, чтобы во всем файле были табуляции.

Да, дело в табуляции и пробелах.
ИМХО нужно для студии исправить, сделав также, как и для ком.строки
  

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: Сборка документации
Ответ #31 - 16. Марта 2008 :: 13:58
Печать  
artbear писал(а) 16. Марта 2008 :: 13:54:
fez писал(а) 16. Декабря 2007 :: 06:22:
На отступы он жалуется. В основной своей массе.
Я так думаю, что ему плохеет от смеси табуляций и пробелов. Это стандартная питоновая фишка: если начал делать отступы пробелами - делай во всем файле пробелами. Если начал табуляцией - нужно, чтобы во всем файле были табуляции.

Да, дело в табуляции и пробелах.
ИМХО нужно для студии исправить, сделав также, как и для ком.строки

Да лучше, наверное, файл подправить, чтобы везде нормально собиралось.
Табы вообще неудобны, в фаре - 8, в студии - 4 (хотя везде можно поменять, конечно), я теперь везде пробелы ставлю.
  

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


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

Сообщений: 4632
Зарегистрирован: 19. Мая 2006
Re: Сборка документации
Ответ #32 - 16. Марта 2008 :: 14:05
Печать  
Хотя еще посмотрел - и правда половина файлов с пробелами, половина с табами Улыбка
То есть и правда пофиг, надо просто бросить монету и исправить в одну сторону.
  

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


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

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

А chm у тебя собирается?

Такой фигни нет?
Цитата:
Building Math : html
Building Math.txt : hhp
Microsoft (R) Windows Script Host Version 5.6
Copyright (C) Microsoft Corporation 1996-2001. All rights reserved.

Y:\1\Documents\html2chm.js(875, 4) Microsoft JScript runtime error: 'null' is null or not an object


Где-то я уже это видел, но не забыл где.
  

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


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

Сообщений: 6303
Местоположение: Москва
Зарегистрирован: 19. Мая 2006
Пол: Мужской
Re: Сборка документации
Ответ #34 - 16. Марта 2008 :: 14:18
Печать  
Из ком.строки все нормально, все собралось.
Посмотри на бывшем тех.форуме, вроде там было Улыбка
  

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: Сборка документации
Ответ #35 - 16. Марта 2008 :: 14:22
Печать  
artbear писал(а) 16. Марта 2008 :: 14:18:
Из ком.строки все нормально, все собралось.
Посмотри на бывшем тех.форуме, вроде там было Улыбка

Не получится.

Ладно, что-нибудь придумаю.
Мне chm самому нафиг не нужен, но видишь - для народа стараюсь.

P.S.
Если там что-то дельное попадется, закинь сюда, плз.
  

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


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

Сообщений: 4632
Зарегистрирован: 19. Мая 2006
Re: Сборка документации
Ответ #36 - 16. Марта 2008 :: 14:52
Печать  
Разобрался, короче.
Я когда-то ставил себе docutils поновее, а под него не заточен сашин скрипт html2chm.js

Пришлось руками убрать каталог "C:\Program Files\Python\Lib\site-packages\docutils" и заново засетапить docutils.

Все зашибись с chm. Улыбка
  

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


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

Сообщений: 4632
Зарегистрирован: 19. Мая 2006
Re: Сборка документации
Ответ #37 - 16. Марта 2008 :: 14:56
Печать  
artbear писал(а) 16. Марта 2008 :: 13:54:
Да, дело в табуляции и пробелах.
ИМХО нужно для студии исправить, сделав также, как и для ком.строки

Я, пожалуй, уберу эту привязку к ширине таба в 4 из скриптов.
ИМХО, должно собираться независимо от ширины таба.
Пусть сами авторы следят за тем, чтобы весь документ был в едином стиле (пробелы или табы).
« Последняя редакция: 16. Марта 2008 :: 16:02 - kms »  

De quelle planète es-tu?
Наверх
 
IP записан
 
dnp
Senior Member
****
Отсутствует


.

Сообщений: 479
Зарегистрирован: 26. Мая 2006
Пол: Мужской
Re: Сборка документации
Ответ #38 - 19. Марта 2008 :: 04:19
Печать  
ссылка на страничке
http://www.1cpp.ru/docum/html/1cpp.html
"Дополнительные классы и ЭУ"
не ведет к
http://www.1cpp.ru/docum/html/extobjs.html

туда, конечно, можно попасть прямо с http://www.1cpp.ru/docum/html/ , но этож знать нужно.
  
Наверх
ICQ  
IP записан
 
artbear
1c++ developer
1c++ moderator
Отсутствует


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

Сообщений: 6303
Местоположение: Москва
Зарегистрирован: 19. Мая 2006
Пол: Мужской
Re: Сборка документации
Ответ #39 - 19. Марта 2008 :: 05:04
Печать  
dnp писал(а) 19. Марта 2008 :: 04:19:
ссылка на страничке
http://www.1cpp.ru/docum/html/1cpp.html
"Дополнительные классы и ЭУ"
не ведет к
http://www.1cpp.ru/docum/html/extobjs.html

туда, конечно, можно попасть прямо с http://www.1cpp.ru/docum/html/ , но этож знать нужно.

Ага, дело в том, что эти html-файлы изначально предназначены для узкой специализации - компиляции в chm, поэтому линки не всегда работают.
Выходов два
1. Исправить сборку этих html таким образом, чтобы исправить эту ошибку. Совсем не просто Печаль
2. Федору (или кому-то еще) один раз сделать простую html-страницу, в которой вместо списка файлов будут нормальные линки на все html. ИМХО самый простой и удобный путь.
Этот файл также можно закинуть в cvs Улыбка и автоматически кидать на сайт.

Что скажете?
  

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


I Love YaBB 2!

Сообщений: 29
Зарегистрирован: 09. Июня 2007
Re: Сборка документации
Ответ #40 - 20. Марта 2008 :: 10:09
Печать  
А еще лучше сделать wiki из документации. Нужно понимать, что несколько человек не могут полностью охватить весь спектр, и сделать красивый и наглядный help. Кто-то напишет один раздел, кто-то другой, третий подправит оба и добавит примеров, вот и будет хорошо.
Но конечно, надо назначить ответственного за это мероприятие, что бы он мог ставить запреты определенным кадрам на редактирование.

А можно еще в документации указывать в каких версиях существует то что описвается?
« Последняя редакция: 21. Марта 2008 :: 11:23 - Babys »  
Наверх
 
IP записан
 
kms
1c++ power user
1c++ moderator
Отсутствует


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

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

Артур, не мог бы ты посмотреть, почему у нас при сборке документации опять ошибки вылезают?
Informer.rst, classes.rst, extobjs.rst.

Это старые ошибки или уже новые?  Подмигивание
Только собери, плз, доку скриптом, который в CVS залит, чтобы у тебя и у нас с Федором были идентичные результаты.
  

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


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

Сообщений: 6303
Местоположение: Москва
Зарегистрирован: 19. Мая 2006
Пол: Мужской
Re: Сборка документации
Ответ #42 - 05. Мая 2008 :: 05:33
Печать  
  

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: Сборка документации
Ответ #43 - 07. Мая 2008 :: 12:06
Печать  
Так ты вроде говорил, что убрал разницу между пробелами и табуляцией ?
Потому что ИМХО ошибки из-за этого опять Печаль
И что-то я твоего ключа (пробелы и табуляция) не вижу Печаль
  

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: Сборка документации
Ответ #44 - 07. Мая 2008 :: 12:12
Печать  
Хотя, возможно, что я и ошибаюсь Улыбка
  

OpenConf developer :: http://openconf.1cpp.ru&&FormEx developer :: http://formex.dorex.ru&&1C++ active developer && tester :: www.1cpp.ru
Наверх
GTalkSkype/VoIPICQ  
IP записан
 
Переключение на Главную Страницу Страницы: 1 2 [3] 4 
ОтправитьПечать