Генерация HTML/CHM для WinAPIEx.au3

[Garrett]

Да, CreatoR, я тоже пришёл к выводу что через картинку будет надёжнее
Я просто её сделал под размер 960рх, с прозрачным градиентом с права.
Вackground ячейки залил вторым светлым цветом, пусть теперь себе тянется от 960рх и до 100%

Вот: CSS

    #logoline{border:0;background:#BAC7EB;}
    #title{color:#BAC7EB; margin:-26px 0 0 10px; font-size:18px}

Вот: HTML

<table width="100%">
	<tr>
		<td id="logoline"><img src="../../images/line.png"></td>
	</tr>
</table>
<h1 id="title">Библиотека WinAPIEx v2.3</h1>

Картинка в атаче.

 

[CreatoR]

Garrett
Как мне это в css прикрутить? сейчас там задаётся стиль элемента:

H1 {
	font-family: Verdana, Arial, Helvetica, sans-serif, "MS sans serif";
	font-size: small;
	line-height: normal;
	color: #FFFFFF;
	background-image: url('index.png');
	background-repeat: repeat-y
}

Добавлено:

Сообщение автоматически объединено: 30 Мар 2010

[?]

Как мне это в css прикрутить?

Нашёл...

H1 {
	font-family: Verdana, Arial, Helvetica, sans-serif, "MS sans serif";
	font-size: small;
	line-height: normal;
	color: #FFFFFF;
	background-image: url('blue_gradient.png');
	background-color:#BAC7EB;
	background-repeat: repeat-y
}

правда картинка немного отличается от оригинала... не проблема, взял оригинал, и фон раскрасил в соот-вий с цветом последнего пикселя изображения (#99C3E6) Хорошая идея, спасибо.

 

[Garrett]

CreatoR [?]

правда картинка немного отличается от оригинала...

Может быть :( Я цвета с картинки Yashied`a брал, пипеткой



Добавлено:

Сообщение автоматически объединено: 30 Мар 2010

Если хотите, я могу подправить, напишите цвета
Или могу скинуть PSD.


Добавлено:

Сообщение автоматически объединено: 30 Мар 2010

Атач, это PSD

 

[CreatoR]

Было бы неплохо если бы кто-то нашёл утилиту (желательно с поддержкой ком. строки), которая компилировала html в chm, но я так поноимаю так просто не получится, нужно ещё генерировать файл таблицы содержимого (TOC), а вот как он должен выглядеть?

 

[Garrett]

CreatoR
Загляните сюда. Может то что нужно?! Хотя, насчёт ком. строки не уверен, если только пощупать dll`ки .

 

[Yashied]

Для генерации "нормальной" справки нужно слишком много параметров, да и каждый под себя захочет ее сделать. Лучше оставь в виде html'ок.

HTML Help Workshop поддерживает коммандную строку, но придется еще создавать сам файл проекта (похож на .ini файл) + Index + TOC.

WinAPIEx_Docs.zip

 

[CreatoR]

Yashied
Супер, сделаю из этого опцию автоматической компиляций в chm.

 

[CreatoR]

Всё, за столь короткий срок написания утилиты - думаю лучше уже просто некуда! :laugh:

* Раскраска кода использует SciTE, на каждый пример запускается полускрытая копия редактора :( - поэтому выглядит данный процесс весьма страшно (видимо зависит от "мощи" системы) - чего правда нельзя сказать о результате после расскраски ;)
- Данный процесс (именно раскраску кода) можно остановить "на лету", сняв соответствующую птичку (если вы конечно умудритесь попасть в неё, т.к полагаю что на скоростной системе, это будет не просто :D ).

* Для корректной компилляций в chm требуется установленный в системе «HTML Help Workshop», на чём ещё оно сказывается точно сказать не могу, но вот без него поиск по справке не работает (буду рад если кто-то подскажет что нужно ещё забрать из него чтобы поиск работал, я полагаю нужен какой то внешний модуль для генераций поисковой системы, вот только какой...).

P.S
Второй файл, с окончанием _bin это чисто бинарник для отдельного запуска, по идее должен работать даже на чистой системе.

Simple_Library_Docs_Generator_0.4_src.zip
Simple_Library_Docs_Generator_0.4_bin.zip

 

[asdf8]

поиск по справке не работает

"HTML Help Workshop" не пользовался, но "PowerCHM" создает небольшой файл с расширением "chi" и пока этот файл лежит рядом с файлом справки - поиск работает.

 

[Yashied]

Все просто супер, но опять несколько комментариев:

• Забыл про "|2", "|3" и т.д., см. _WinAPI_DragQueryFileEx() - Return values и _WinAPI_QueryInformationJobObject() - Parameters.
• *.htm файлы лучше помещать вместе с Index.htm и папкой css, а то не цепляются стили.
• Раскраска супер, но нельзя ли сделать шрифт как в офф. справке, и возможность по желанию отключать линки на стандартные AutoIt функции (иначе справка замучает предупреждениями при отсутствии интернета или Firewall будет ругаться)?
• Примеры у меня лежат в отдельной папке, может лучше добавить путь к примерам?

:-[

А в остальном просто нет слов!

Спасибо.

Да, и еще, при использовании раскраски кода, HTML Help Workshop ругается на пустые строки в тэгах, но справку создает.

WinAPIEx.chm



Добавлено:

Сообщение автоматически объединено: 30 Мар 2010

...но вот без него поиск по справке не работает...

В скомпилированном .chm поиск прекрасно работает и при отсутствии HTML Help Workshop.

 

[kaster]

хм. а у меня нет никакой раскраски. просто бледно синий текст в примерах

 

[Yashied]

хм. а у меня нет никакой раскраски. просто бледно синий текст в примерах

Должен быть установлен SciTE (возможно полная версия) и стоять соответствующая галочка в программе. Или может быть у тебя SciTE установлен не в папке с AutoIt.

 

[CreatoR]

Yashied [?]

Забыл про "|2", "|3" и т.д.

Не забыл, а поставил но не везде ;)

см. _WinAPI_DragQueryFileEx() - Return values

Как раз там это в Parameters...

_WinAPI_QueryInformationJobObject() - Parameters

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

нельзя ли сделать шрифт как в офф. справке

Можно, это настраивается в default.css, под «.codebox {...» (FONT-SIZE/FONT-FAMILY). А какой нужно?

возможность по желанию отключать линки на стандартные AutoIt функции

Да, я как раз для этого оставил параметр $iAdd_URLs в функций _AU3Lib_ConvertXmlToHtml, при вызове нужно поставить на 0. Если нужно могу добавить опцию в GUI.

Примеры у меня лежат в отдельной папке, может лучше добавить путь к примерам?

Ты вроде говорил что добавишь их в «Example...:», скрипт оттуда будет считывать, но могу и сделать отдельно поле для этого пути.
Кстати, если нужно, могу ещё дать выражение для поиска и замены в SciTE (птичка Regular Expression), чтобы одним махом подставить туда пути к примерам ;)

при использовании раскраски кода, HTML Help Workshop ругается на пустые строки в тэгах

Ещё бы узнать какие теги и где именно... и это не на пустые строки, а на пустые теги.

 

[gregaz]

Kaster [?]

хм. а у меня нет никакой раскраски. просто бледно синий текст в примерах

А у меня все есть. Класс

 

[CreatoR]

Yashied [?]

Или может быть у тебя SciTE установлен не в папке с AutoIt.

Если SciTE не найден скрипт выводит сообщение и позволяет указать путь до него.


Добавлено:

Сообщение автоматически объединено: 30 Мар 2010

[?]

Ещё бы узнать какие теги и где именно

Нашёл, это <font color="red"><></font>, операторы сравнения - заменил на &lt;&gt;.

 

[Yashied]

CreatoR

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

А разве это будет работать только для конкретных функций? Это функция есть в последней версии - 2.3.

Можно, это настраивается в default.css, под «.codebox {...» (FONT-SIZE/FONT-FAMILY). А какой нужно?

Такой же, как и без раскраски (разница будет только в цвете).

Да, я как раз для этого оставил параметр $iAdd_URLs в функций _AU3Lib_ConvertXmlToHtml, при вызове нужно поставить на 0. Если нужно могу добавить опцию в GUI.

Супер.

Ты вроде говорил что добавишь их в «Example...:», скрипт оттуда будет считывать, но могу и сделать отдельно поле для этого пути.

Супер №2.



Добавлено:

Сообщение автоматически объединено: 30 Мар 2010

CreatoR, символ "|" вообще можно везде по тексту убирать, ЕСЛИ после него стоит "|TRUE", "|FALSE" или "|0...9" (любая цифра).

 

[kaster]

Yashied [?]

Должен быть установлен SciTE

стоит версия от руборда

и стоять соответствующая галочка в программе

а можно поподробнее? что за галке и в какой программе? :whistle:

Или может быть у тебя SciTE установлен не в папке с AutoIt

нет. в отдельной папке в Program Files

а вообще, я чето не пойму, как скомпилированный chm может использовать внешний Scite

 

[Yashied]

...а вообще, я чето не пойму, как скомпилированный chm может использовать внешний Scite.

Выходит, что может. Это лучше у CreatoR'а спросить.

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

CreatoR, я разобрался, для того, чтобы скомпилировать .chm, достаточно всего два файла:

hhc.exe
hha.dll

Но для корректной работы поиска нужен еще зарегистрированный в системе следующий файл:

itcc.dll

Все это я положил в архив.

hhc.zip

 

[CreatoR]

Yashied [?]

Это функция есть в последней версии - 2.3.

А у меня 2.2...

Такой же, как и без раскраски

Ну там по идее кроме «<font color=» ничего не добавляется, шрифт должен быть таким же. Что именно изменяется?

символ "|" вообще можно везде по тексту убирать, ЕСЛИ после него стоит "|TRUE", "|FALSE" или "|0...9" (любая цифра).

Я так и сделал, просто для параметров не применял.


Kaster [?]

стоит версия от руборда

Она там накрученная перекрученная, не то.

что за галке и в какой программе?

В той о которой тема ;)

нет. в отдельной папке в Program Files

Что показывает ConsoleWrite($sSciTEDir) если поместить это после «#EndRegion Global Variables»?

как скомпилированный chm может использовать внешний Scite

Это нужно для процесса раскраски в процессе генерирования файлов справки, после компиляций уже ничего не нужно.


Добавлено:

Сообщение автоматически объединено: 30 Мар 2010

Yashied [?]

для того, чтобы скомпилировать .chm, достаточно всего два файла:

Ну если ты скачал мой последний архив, то должен был заметить там эти файлы ;)

для корректной работы поиска нужен еще зарегистрированный в системе следующий файл

Отлично, щас потестим.

 

[Yashied]

Я так и сделал, просто для параметров не применял.

Сделай пож. для всех разделов.
:-[