Документирование MSEide + MSEgui

Вопросы программирования и использования MSEide + MSEgui.

Модератор: Модераторы

Сообщение al_exus » 19.11.2007 02:10:22

Alexander писал(а):
debi12345 писал(а): На запись - не умею.


al_exus писал(а):Не, пусть как все - пользователем, заодно добавит что знает, а то админом будет только руководить


:)

А ты всерьёз за МСЕ взялся ?


Alexander, этот вопрос мне?
Я пишу на фоксе, MSEIDE изучаю "факультативно", дома, просто есть ощущение серьезности проекта. Хочется убедиться и, возможно, в дальнейшем использовать как альтернативу Фоксу. Пока что, для пробы, сделал парочку небольших программ (конвертор проводок для экспорта в систему SAP R/3 и вьювер-телефонный справочник города). Сейчас взялся за третью, в плане структуры - чуть посерьезнее двух первых, пока на стадии набивания шишек по каждому поводу.
al_exus
новенький
 
Сообщения: 24
Зарегистрирован: 20.09.2007 00:18:11

Сообщение Alexander » 30.11.2007 01:15:39

Майонез - это драйвер для борща.


:lol:

А перевести это Мартину стоило. Ему же интересно.
Аватара пользователя
Alexander
энтузиаст
 
Сообщения: 771
Зарегистрирован: 18.12.2005 19:10:00
Откуда: оттуда

Сообщение Attid » 30.11.2007 01:34:21

зафлудили ветку =) пусть про моенез все прочитают, и я её прорежу.
Аватара пользователя
Attid
долгожитель
 
Сообщения: 2585
Зарегистрирован: 27.10.2006 17:29:15
Откуда: 44°32′23.63″N 41°2′25.2″E

Сообщение Alexander » 30.11.2007 15:13:05

al_exus, а тебе доступ к SVN нужен ?
Аватара пользователя
Alexander
энтузиаст
 
Сообщения: 771
Зарегистрирован: 18.12.2005 19:10:00
Откуда: оттуда

Сообщение Alexander » 11.12.2007 17:50:57

О ! А в проекте документирования произошли подвижки !

debi12345, спасибо !
Аватара пользователя
Alexander
энтузиаст
 
Сообщения: 771
Зарегистрирован: 18.12.2005 19:10:00
Откуда: оттуда

Сообщение debi12345 » 11.12.2007 21:11:17

Я ничего и не делал :)
Это нас европейцы на буксир взяли (как всегда). А мы все идеалы ищем да щеки надуваем.
Человек стал выкладывать в примеры все мелкие тестовые проекты, по которым изучает библитеку. Умница, правда ?
Аватара пользователя
debi12345
долгожитель
 
Сообщения: 5759
Зарегистрирован: 10.05.2006 23:41:15
Откуда: Ташкент (Узбекистан)

Сообщение al_exus » 12.12.2007 05:46:44

Alexander писал(а):al_exus, а тебе доступ к SVN нужен ?

В будущем, пока от меня проку никакого, так как, пока осознание еще не пришло, тыкаюсь практически вслепую и при каждом шаге получаю шваброй в лоб.
al_exus
новенький
 
Сообщения: 24
Зарегистрирован: 20.09.2007 00:18:11

Сообщение Alexander » 12.12.2007 19:17:39

al_exus писал(а):В будущем


Когда захочешь, создай аккаунт на sourceforge.net и
запомни пароль. Логин сообщи, я его зарегю.

al_exus писал(а): пока осознание еще не пришло, тыкаюсь практически вслепую и при каждом шаге получаю шваброй в лоб.


Я тоже.
Аватара пользователя
Alexander
энтузиаст
 
Сообщения: 771
Зарегистрирован: 18.12.2005 19:10:00
Откуда: оттуда

Сообщение Alexander » 25.02.2008 18:46:20

Кто нибудь запускал скрипты автодокументирования в последнее
время ? А то я или забыл, что на что в .ini файлах менять или древо
FPC изменилось по структуре. Второй вариант вероятнее.
Аватара пользователя
Alexander
энтузиаст
 
Сообщения: 771
Зарегистрирован: 18.12.2005 19:10:00
Откуда: оттуда

Сообщение debi12345 » 25.02.2008 19:07:57

Для МСЕ ничего менять не надо.
А вот чтобы слепило и увязало с ФПК - надо. Я это сделаю, когда ФПК-тим устранит жесткий баг на ХМЛ-тэгах в fpdoc.
Аватара пользователя
debi12345
долгожитель
 
Сообщения: 5759
Зарегистрирован: 10.05.2006 23:41:15
Откуда: Ташкент (Узбекистан)

Сообщение Alexander » 25.02.2008 19:29:48

Ааа. Понятно.
Аватара пользователя
Alexander
энтузиаст
 
Сообщения: 771
Зарегистрирован: 18.12.2005 19:10:00
Откуда: оттуда

Сообщение Attid » 19.03.2008 14:56:49

в общем опять все стало =) я немного пофилосовствую , можно ?

вот мне лично хмл не нравится этот совсем =) не потому что я против хмл, а вот просто не понятно что там и куда и чего.

за сим все таки прелогаю изучить чью нибуть дружественую систему документации, например пхп или дебиан.

ну а в качесве маяка это дока от дельфи, потому что в отличаи от пхп у паскаля есть открытые \ закрытые(protected\public\etc) свойства

формат хранения как уже порешили лучше всего текстовый, хранение картинок пнг.

структура
1 куча вложеных папок и там описание
я бы применил структуру как она распологается на панели компонентов, облегчит поиск и понимание.
2 умный хмл, может и тот что есть пойдет, хотя опять же ИМХО он сделан не удобно
*должны поодерживаться внутрении ссылки (в свн есть?) напрмер свойство name есть у всех компонентов и что его 40 раз заполнять и копировать ? оно должно хранится в одном месте, и сделав перевод одно абзаца на другой язык , мы получим 40 переведеных абзацев !

заполнение. это самое слабое звено во первых надо показать что это просто. во первых человек и так не понимает что там и как живет а ему еще предлогают документировать это не пойми что и не пойми как.
соответсвенно имхо это должна быть программа, расположение контролов оставить дизайнерам, как это я вижу себе
1, выбираем язык ввода,
2, выбираем(вписываем) компонент\класс
2,1 програма автоматом или с помощью пользователя находит юнит где живет данный компонент
2,2 программа автоматом выводит свойства и функции с разделением на палик\паблишен и т.д.
3, пользователь заполняет и комитит изменения
3,1 для компонентов можно добавлять пару картинок


ну а следующим шагом уже будет создания проги которая собирает это все в хтмл\пдф\чмо\хлп по желанию.
Аватара пользователя
Attid
долгожитель
 
Сообщения: 2585
Зарегистрирован: 27.10.2006 17:29:15
Откуда: 44°32′23.63″N 41°2′25.2″E

Сообщение debi12345 » 19.03.2008 22:25:58

Не "стало" - я набиваю массив доки. Это в миллион раз нуднее и труднее, чем программы писать - поэтому и имеет тенденцию "останавливаться".

Про формат - решайте, пробуйте. Главное - чтобы было, что "форматировать".
Аватара пользователя
debi12345
долгожитель
 
Сообщения: 5759
Зарегистрирован: 10.05.2006 23:41:15
Откуда: Ташкент (Узбекистан)

Сообщение debi12345 » 20.03.2008 08:03:17

*должны поодерживаться внутрении ссылки (в свн есть?) напрмер свойство name есть у всех компонентов и что его 40 раз заполнять и копировать ? оно должно хранится в одном месте, и сделав перевод одно абзаца на другой язык , мы получим 40 переведеных абзацев !

1, выбираем язык ввода,
2, выбираем(вписываем) компонент\класс
2,1 програма автоматом или с помощью пользователя находит юнит где живет данный компонент
2,2 программа автоматом выводит свойства и функции с разделением на палик\паблишен и т.д.
3,1 для компонентов можно добавлять пару картинок
============
FPDOC это обеспечивает. Да он все обеспечивает, кроме вставки картинок.

ИМХО, Идеальный редактор хэлпа на конечной стадии ( HTML ) - DramWeaver. Я на нем туториал "persons" ваял.
Аватара пользователя
debi12345
долгожитель
 
Сообщения: 5759
Зарегистрирован: 10.05.2006 23:41:15
Откуда: Ташкент (Узбекистан)

Сообщение Attid » 20.03.2008 10:51:57

debi12345
так ты что нибуть закомитил в свн, может так бы хоть понял что там и к чему. и на принтер ты мне не ответил =( наверно не заметил сообщения. .


может я заблуждаюсь , но FPDOC нихрена не обеспечивает кроме того что создает доку по коментариям , и даже не имеет своей морды. поправте меня если это не так.

там еще необходим пункт
4 должны быть флаги в работе и "незаконченый" с поддержкой времени

чтобы типа если в работе пол года, то про него забыли =(


ЗЫ debi12345 форум поддерживает удобное цитирование и понятное для всех для этого надо всего лишь выделить текст и нажать слева кнопку "цитировать" над аватаром.
Аватара пользователя
Attid
долгожитель
 
Сообщения: 2585
Зарегистрирован: 27.10.2006 17:29:15
Откуда: 44°32′23.63″N 41°2′25.2″E

Пред.След.

Вернуться в MSEide + MSEgui

Кто сейчас на конференции

Сейчас этот форум просматривают: нет зарегистрированных пользователей и гости: 2

Рейтинг@Mail.ru