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

[Garrett]

Кстати, если кому интересно, то вот генераторы au3.user.calltips.api и au3.userudfs.properties для WinAPIEx.au3. Можно легко переделать под любой другой UDF.

Не знал.
Спасибо!


Добавлено:

Сообщение автоматически объединено: 1 Апр 2010

Вы код писали?

 

[Yashied]

Да.

 

[Garrett]

Отличная утилита получится, если ещё GUI прикрутить ;D
Generator files .api

 

[Yashied]

Для au3.user.calltips.api у меня нет утилиты, т.к. я не пользуюсь этим, а в SciTE вообще отключил эту опцию. А раскрашивать функции я люблю, особенно из своих UDF'ок.



Для этого я даже написал в свое время утилиту. Правда она немного неповоротливая, поскольку писалась "по быстрому", а довести до ума банально лень, но работает как часы.

 

[Garrett]

Yashied [?]

А раскрашивать функции я люблю, особенно из своих UDF'ок.

Творческий подход!

 

[Yashied]

Вообщем вот, что окончательно получилось. Если бы еще к примерам добавить кнопку для копирования его (примера) в буфер обмена...



WinAPIEx.zip

 

[CreatoR]

Simple_Library_Docs_Generator_0.5_src.zip
Simple_Library_Docs_Generator_0.5_bin.zip



Добавлено:

Сообщение автоматически объединено: 2 Апр 2010

Yashied [?]

Если бы еще к примерам добавить кнопку для копирования его (примера) в буфер обмена...

Можно, но только для IE...


Добавлено:

Сообщение автоматически объединено: 2 Апр 2010

[?]

Можно, но только для IE...

Обновил архивы, только это и добавил.

 

[Yashied]

Да, мощная утилита получилась, спасибо еще раз. Я думаю это нужно разместить в "Примерах..." или в "Инструменты и помощь по AutoIt".

:beer:

P.S

Но я шрифт для примеров все равно поставил Courier New.

 

[Yashied]

Правда, я делаю на русском...

А на какой уже стадии?

 

[CreatoR]

Yashied [?]

А на какой уже стадии?

Кстати, можно с таким же успехом перевести заголовки всех функций и сгенерировать справку, но некоторые значения конечно трогать нельзя, иначе придётся и в скрипте править.

 

[Yashied]

Ну, теперь вся надежда на Garrett'а.

 

[Garrett]

Правда, я делаю на русском...

А на какой уже стадии?

Всё дело в моём Английском :-[
В некоторых моментах мне очень трудно сориентироваться в грамотном (техническом) переводе (хотя я, плотно дружу с Google)!
Что касаемо стилевого оформления шаблонов HTML, то, здесь я прямо скажу, они отличаются от оригинальных страниц, потому как я не ставил себе целью полного совпадения с оригинальными HTML шаблонами, хотя структура та же.
HTML + CSS шаблоны готовы, просто по ходу перевода и набора текста, делаю разного рода поправки, но это уже мелочи
Так что, на стадии наполнения контентом

OffTopic:
От себя лично!
Yashied, вами проделана большая работа, за что вам большое спасибо!
CreatoR, снимаю шляпу перед вашей оперативностью, знатная получилась справка!

Добавлено:

Сообщение автоматически объединено: 2 Апр 2010

CreatoR [?]

Кстати, можно с таким же успехом перевести заголовки всех функций...

CreatoR
Нет, нет! Здесь IMHO не нужен перевод!

 

[CreatoR]

Garrett [?]

Здесь IMHO не нужен перевод!

Я про заголовки в самой библиотеке ;)

; #FUNCTION# ====================================================================================================================
; Name...........: _WinAPI_AboutDlg
; Description....: Displays an Windows About dialog box.
; Syntax.........: _WinAPI_AboutDlg ( $sTitle, $sName, $sText [, $hIcon [, $hParent]] )
; Parameters.....: $sTitle  - The title of the Windows About dialog box.
;                  $sName   - The first line after the text "Microsoft".
;                  $sText   - The text to be displayed in the dialog box after the version and copyright information.
;                  $hIcon   - Handle to the icon that the function displays in the dialog box.
;                  $hParent - Handle to a parent window.
; Return values..: Success  - 1.
;                  Failure  - 0 and sets the @error flag to non-zero.
; Author.........: Yashied
; Modified.......:
; Remarks........: None
; Related........:
; Link...........: @@MsdnLink@@ ShellAbout
; Example........: Yes
; ===============================================================================================================================

Добавлено:

Сообщение автоматически объединено: 13 Апр 2010

Обновление утилиты - самое главное изменение состоит в том, что теперь для раскраски используется «AutoItSyntaxHighlight - Библиотека для подсветки синтаксиса AutoIt-кода», а не SciTE, что ускоряет процесс подсветки всех примеров во много раз (на всю библиотеку WinAPIEx на моём компе ушло меньше двух минут):

Simple_Library_Docs_Generator_0.6_src.zip
Simple_Library_Docs_Generator_0.6_bin.zip

 

[AZJIO]

CreatoR

- Хотя есть наверное вариант заполнения градиентом, но это нужно искать в доках по css.

<table cellspacing="0" cellpadding="0" border="0" width="100%">
		<td style=' filter:progid:DXImageTransform.Microsoft.Gradient(GradientType=1, StartColorStr="#010080", EndColorStr="#98C3E6"); color: #FFFFFF; font-size:12pt; padding:0px 0px 0px" '><strong>WinAPIEx Library</strong></td>
</table>

Для css это выглядит так:

.gr
{filter:progid:DXImageTransform.Microsoft.Gradient(GradientType=1, StartColorStr="#010080", EndColorStr="#98C3E6");
	color: #FFFFFF;
	font-size:12pt;
	width:100%;
	font-weight: bold;}

<p class='gr'>Function Reference</p>

Хотя глянул я размер картинки в последней версии, всего 1 кб, можно ничего не менять, или repeat-y добавить, а картинку в однопиксельную строку.
Отступ слева 5 и вверх/вниз по 1 (padding:1px 0px 1px 5px;) можно добавить, нестандартно, но не впритык.

А ещё бы возможность задавать стили, всего лишь выбором style.css, вот пример.


CreatoR

В папку рядом с «AutoIt3Help.exe» помещаем файл «WinAPIEx.chm» (наш файл справки), сам файл «AutoIt3Help.exe» переименовываем в «~AutoIt3Help.exe», и пишем в этой же папке следующий скрипт:

Я недавно всё обгуглил, нигде не нашёл AutoIt3Help.exe, и в установленном SciTE4AutoIt3 у меня нет AutoIt3Help.exe. Может кто нибудь выложит?

А может ещё добавить кнопку "Открыть" как в официальной справке? У меня при таком раскладе скрипты сразу выполняются без лишних движений.

CreatoR [?]

теперь для раскраски используется «AutoItSyntaxHighlight - Библиотека для подсветки синтаксиса AutoIt-кода», а не SciTE

У меня первый раз скрипт вылетел после 2-ти минут обработки, второй раз убрал галочку генерации ссылок, скомпилировалось, но вместо au3-кода получился html-код.