powered by simpleCommunicator - 2.0.59     © 2026 Programmizd 02
Целевая тема:
Создать новую тему:
Автор:
Закрыть
Цитировать
Форумы / Firebird, InterBase [игнор отключен] [закрыт для гостей] / FB DDL to HTML
25 сообщений из 51, страница 2 из 3
FB DDL to HTML
    #38936712
Шавлюк Евгений
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
DarkMaster,

А почему DLL, а не DDL?

Модератор: заголовок исправил
...
Рейтинг: 0 / 0
FB DDL to HTML
    #38936774
Фотография Симонов Денис
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
ExterisЧёт не пойму. А чем в ibexpert-е документатор не устраивает?

Да пусть пишет. Это хорошая тренировка для ума. Системные таблицы выучит. Да и может им нужен особый формат документации.
Уж если на то пошло то можно сделать сначала генерирование xml а потом xslt преобразованием фигачить его в различные форматы HTML/PDF/RTF... XLSки готовые рядом с прогой кинуть. Кто хочет может поменять под себя
...
Рейтинг: 0 / 0
FB DDL to HTML
    #38936796
Фотография DarkMaster
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Симонов ДенисExterisЧёт не пойму. А чем в ibexpert-е документатор не устраивает?

Да пусть пишет. Это хорошая тренировка для ума. Системные таблицы выучит. Да и может им нужен особый формат документации.
Уж если на то пошло то можно сделать сначала генерирование xml а потом xslt преобразованием фигачить его в различные форматы HTML/PDF/RTF... XLSки готовые рядом с прогой кинуть. Кто хочет может поменять под себя

Мне нужен тул, который при вызове из командной строки выдернет нужный мне обьект из БД (или набор обьектов) и быстро сгенерит доку. В ИБЭ мне нужно порядком нащелкать кнопочек.

P.S. Кстати, при больших изменениях можно неплохо синтегрироваться с Экспертом - выдергиваем из IBE$xxxx таблиц список последних изменений - отдаем утилите - получаем актуальную доку.

P.P.S. Кто сказал, что я системных таблиц не знаю?-)
...
Рейтинг: 0 / 0
FB DDL to HTML
    #38936803
Фотография DarkMaster
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Симонов ДенисDarkMaster,

замечания
1.
Код: sql
1.
    NAME VARCHAR(50) CHARACTER SET WIN1251 COLLATE WIN1251  NOT NULL);



если чарсет столбца совпадает с чарсетом базы не надо его в скрипт пихать


Учту, но наверное не сейчас, а чуть позже...

Симонов Денис2. в процедурах

первую скобку лучше вот так писать

Код: sql
1.
CREATE PROCEDURE SP_AUTHORIZED (



Это - легко.

Симонов Денис3. RDB$DESCRIPTION (COMMENT ON) надо для всех объектов выводить, а не только для таблиц и их столбцов. Они так же есть у процедур и их параметров, исключений, триггеров. Параметры процедур можно тоже в виде отдельных табличек рисовать.

4. Для процедур, триггеров лучше CREATE OR ALTER писать, ведь для таблиц то RECREATE сделано.

Учту.

Симонов ДенисВообще надо настройку более подробной сделать. Какие типы объектов экспортировать.

P.S. В IBE есть похожий инструмент Инструменты->HTML документация

И получить тот же тул, только отдельно от ИБЭ? Я пока в сторону ком. строки смотрю.
...
Рейтинг: 0 / 0
FB DDL to HTML
    #38936815
Фотография Симонов Денис
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
DarkMaster,

вывод в XML с последующим XSLT преобразованием в HTML/PDF... не рассматриваешь?
...
Рейтинг: 0 / 0
FB DDL to HTML
    #38936847
Фотография DarkMaster
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Симонов Денис,

В планах - в принципе возможно, но явно после v1.0.
...
Рейтинг: 0 / 0
FB DDL to HTML
    #38936876
Мимопроходящий
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Hello, Симонов Денис!
You wrote on 15 апреля 2015 г. 11:13:47:

Симонов Денис> вывод в XML с последующим XSLT преобразованием в HTML/PDF...
> не рассматриваешь?
чо-то я вот тута не нашел PDF-а
Posted via ActualForum NNTP Server 1.5
...
Рейтинг: 0 / 0
FB DDL to HTML
    #38936883
Фотография Симонов Денис
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Мимопроходящий,

он там особым образом генерится через XSLT-FO. Докбук который в XML именно так PDF генерит
...
Рейтинг: 0 / 0
FB DDL to HTML
    #38936888
Мимопроходящий
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Hello, Симонов Денис!
You wrote on 15 апреля 2015 г. 11:22:21:

Симонов Денис> он там особым образом генерится через XSLT-FO.
> Докбук который в XML именно так PDF генеритчудовищно.

зы: ты случаем не в курсе, отчего именно докбук взяли документописатели?
Posted via ActualForum NNTP Server 1.5
...
Рейтинг: 0 / 0
FB DDL to HTML
    #38936899
Фотография Симонов Денис
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Мимопроходящийчудовищно.

зы: ты случаем не в курсе, отчего именно докбук взяли документописатели?


уж как есть. В докбуке легко настроить общий стиль для всего документа. Там точно ничего не поплывёт, не собьётся нумерация и т.д. Хотя для самого редактора это ужас. Благо есть инструменты позволяющие редактировать этот XML более менее в WYSIWYG виде
...
Рейтинг: 0 / 0
FB DDL to HTML
    #38936917
dimitr
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
докбук хоть вещь и слегка окаменевшая, но люто мощная и в какой-то мере является стандартом (ну или одним из). Вот только работать с ней неофитам тяжело, так что для контрибьюторов оно слабо подходит...

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

у меня есть некоторые мысли, как это можно было бы улучшить, но я доку не пишу :-)
...
Рейтинг: 0 / 0
FB DDL to HTML
    #38936935
Мимопроходящий
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Hello, Dimitr!
You wrote on 15 апреля 2015 г. 12:14:28:

Dimitr> у меня есть некоторые мысли, как это можно было бы улучшить, но я доку
> не пишу :-)дык вбрось мысли в народные массы.
авось чо и произрастёт.
Posted via ActualForum NNTP Server 1.5
...
Рейтинг: 0 / 0
FB DDL to HTML
    #38936940
Фотография Симонов Денис
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Мимопроходящий,

здесь это оффтоп, есть же специальный топик. К слову. Русскоязычная полная документация которая сейчас пишется под FB 3 сделана как раз в формате докбук.
...
Рейтинг: 0 / 0
FB DDL to HTML
    #38941858
Фотография DarkMaster
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Симонов Денис,

FBDDL2Html v0.9 загружаем отсюда, кому интересно .

[+] командная строка (commandline.txt - описание ключей + интеграция с IBE/IBEScript)
[+] авто старт/закрытие, если мы в "режиме ком. строки"
[*] поправлена генерация SQL для хранимок
[+] описание параметров для хранимок
[*] разные мелочи

Пока не доделал:
- нет подсветки синтаксиса для hex литералов (0xXXX). Не все встроенные функции распознаются (т.е. нет подсветки для функций типа left(),trim() и т.п.) - в принципе все это добро описывается в SQL.hlg - так что можно довести до ума самостоятельно.
- тул однопоточный, т.е. в принципе можно кое-что выдавить по быстродействию

В конце мая надеюсь вернуться к доработкам и внесению новых фишек, которые вы ( надеюсь ;) предложите. Раньше - только критические баги - пока загружен + в отпуск хочется ;)
...
Рейтинг: 0 / 0
FB DDL to HTML
    #38941863
Фотография DarkMaster
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
И да - выходной результат - теперь файл, а не каталог.
...
Рейтинг: 0 / 0
FB DDL to HTML
    #38943083
afgm
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
DarkMaster,
не очень понимаю конечную цель утилиты, но уж если делать, то делать "чтобы красиво".
Для примера , добавь после своего стиля, разница должна порадовать:
Код: css
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
.........
.bdssynuni1-symbol0 { color: #000000; }
.bdssynuni1-systemfunctionsandvariables0 { color: #008000; }
/* Вот это добавляем */
body {
	font-family: Verdana, Arial, Helvetica, sans-serif;
}

table {
	border-collapse: collapse;
}

td {
	padding: 1px 5px 1px 5px; 
	border: 1px solid silver;
}

td[bgcolor=silver] {
	background: #EEE;
	font-weight: bold;
}
/*^^^*/
-->
</style>
...
Рейтинг: 0 / 0
FB DDL to HTML
    #38943829
Фотография DarkMaster
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Обновлен FBDDL2HTML v0.9.1. Заинтересованным - качать здесь .

P.S. afgm - стили добавил, стало смотреться более симпатично, спасибо.
...
Рейтинг: 0 / 0
FB DDL to HTML
    #38944011
afgm
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
DarkMaster,
Тогда ещё кусочек :)
Код: css
1.
2.
3.
4.
5.
6.
pre {
	border: 1px solid silver;
	border-radius: 5px;
	padding: 5px;
	box-shadow: 1px 1px 0 silver;
}


Вообще желательно всё переверстать в последствии. Но пока и так будет хорошо.
...
Рейтинг: 0 / 0
FB DDL to HTML
    #38952931
Фотография DarkMaster
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
В предверии праздников - FBDDL2HTML v0.9.2.

- пофиксил извлечение значений для параметров по умолчанию
- корректно извлекаются "закавыченные" метаданные (не, ну нафига вообще эту ересь ввели?)
- поправлен информационный блок для таблицы
- мелкие правки

Если интересно - качаем отсюда
...
Рейтинг: 0 / 0
FB DDL to HTML
    #38952937
Мимопроходящий
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Hello, Darkmaster!
You wrote on 6 мая 2015 г. 18:02:24:

Darkmaster> корректно извлекаются "закавыченные" метаданные
> (не, ну нафига вообще эту ересь ввели?)
об чём речь?
можно пример?
Posted via ActualForum NNTP Server 1.5
...
Рейтинг: 0 / 0
FB DDL to HTML
    #38952948
Фотография DarkMaster
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Мимопроходящий,

Я об идентификаторах типа "ItsMyCoolProcedure"... Там еще один маленький бажок вроде непофикшенным остался - нужно проверить.
...
Рейтинг: 0 / 0
FB DDL to HTML
    #38952960
Шавлюк Евгений
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
DarkMaster,

1. Архив называется 11_FBDDL2Html_0.9..zip, а программа FBDLL2Html.exe
2. При просмотре информации о таблице имена триггеров "заковычиваются". Зачем, если они у меня все в верхнем регистре?. Проверять если NAME <> upper(NAME) тогда может кавычки и нужны, хотя тот еще вопрос. Скорее выводить без кавычек в любом случае
3. Клик на имя триггера не переносит к объявлению триггера
4. Не извлекаются collation (к слову сказать, IBExpert тоже их игнорирует)
пример:
Код: sql
1.
create collation NUMERIC_SORT for utf8 from unicode case insensitive 'NUMERIC-SORT=1'


5. Пожелание. А можно было бы сворачивать все таблицы под слово "Tables" и т.д. Неудобно для большой базы просматривать.
...
Рейтинг: 0 / 0
FB DDL to HTML
    #38952962
Шавлюк Евгений
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
6. При извлечении default значения домена добавляется лишний пробел (между INTEGER и DEFAULT)
Код: sql
1.
CREATE DOMAIN DINT1 AS INTEGER  DEFAULT 1;
...
Рейтинг: 0 / 0
FB DDL to HTML
    #38952968
Фотография Симонов Денис
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Шавлюк Евгений2. При просмотре информации о таблице имена триггеров "заковычиваются". Зачем, если они у меня все в верхнем регистре?. Проверять если NAME <> upper(NAME) тогда может кавычки и нужны, хотя тот еще вопрос. Скорее выводить без кавычек в любом случае


не просто проверять на верхний регистр не прокатит. Там должно помимо верхнего регистра проверяться также правило соответствия идентификатора 1 диалекту. Т.е. чтобы пробелов не было, присутствовали только символы ASCII...
...
Рейтинг: 0 / 0
FB DDL to HTML
    #38952971
Шавлюк Евгений
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
7. Извлечение процедур.
Сравниваю IBExpert и FBDLL2Html

FBDLL2Html
Код: sql
1.
2.
3.
4.
5.
6.
7.
CCREATE OR ALTER PROCEDURE BEFORE_SAVEDELTA
    (HOST_ID INTEGER,
    OLDEST_TR INTEGER,
    ENDID INTEGER= null)
RETURNS
    (END_ID INTEGER)
AS



IBExpert
Код: sql
1.
2.
3.
4.
5.
6.
7.
create or alter procedure before_savedelta (
    host_id integer,
    oldest_tr integer,
    endid integer = null)
returns (
    end_id integer)
AS



Отличия:
1) открывающаяся скобка на предыдущей строке
2) Перед "=" в default параметре стоит пробел
...
Рейтинг: 0 / 0
25 сообщений из 51, страница 2 из 3
Форумы / Firebird, InterBase [игнор отключен] [закрыт для гостей] / FB DDL to HTML
Найденые пользователи ...
Разблокировать пользователей ...
Читали форум (0):
Пользователи онлайн (0):
x
x
Закрыть


Просмотр
0 / 0
Close
Debug Console [Select Text]