Что нового

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

Garrett

Модератор
Локальный модератор
Сообщения
3,999
Репутация
967
Yashied сказал(а):
Кстати, если кому интересно, то вот генераторы au3.user.calltips.api и au3.userudfs.properties для WinAPIEx.au3. Можно легко переделать под любой другой UDF.
Не знал. :smile:
Спасибо!


Добавлено:
Сообщение автоматически объединено:

Вы код писали?
 
Автор
Yashied

Yashied

Модератор
Команда форума
Глобальный модератор
Сообщения
5,379
Репутация
2,724

Garrett

Модератор
Локальный модератор
Сообщения
3,999
Репутация
967
Отличная утилита получится, если ещё GUI прикрутить ;D
Generator files .api
 
Автор
Yashied

Yashied

Модератор
Команда форума
Глобальный модератор
Сообщения
5,379
Репутация
2,724
Для au3.user.calltips.api у меня нет утилиты, т.к. я не пользуюсь этим, а в SciTE вообще отключил эту опцию. А раскрашивать функции я люблю, особенно из своих UDF'ок.

:smile:

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

Yashied

Модератор
Команда форума
Глобальный модератор
Сообщения
5,379
Репутация
2,724
Вообщем вот, что окончательно получилось. Если бы еще к примерам добавить кнопку для копирования его (примера) в буфер обмена...

:smile:

WinAPIEx.zip
 

CreatoR

Must AutoIt!
Команда форума
Администратор
Сообщения
8,671
Репутация
2,481
Simple_Library_Docs_Generator_0.5_src.zip
Simple_Library_Docs_Generator_0.5_bin.zip



Добавлено:
Сообщение автоматически объединено:

Yashied [?]
Если бы еще к примерам добавить кнопку для копирования его (примера) в буфер обмена...
Можно, но только для IE...


Добавлено:
Сообщение автоматически объединено:

[?]
Можно, но только для IE...
Обновил архивы, только это и добавил.
 
Автор
Yashied

Yashied

Модератор
Команда форума
Глобальный модератор
Сообщения
5,379
Репутация
2,724
Да, мощная утилита получилась, спасибо еще раз. Я думаю это нужно разместить в "Примерах..." или в "Инструменты и помощь по AutoIt".

:beer:

P.S

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

CreatoR

Must AutoIt!
Команда форума
Администратор
Сообщения
8,671
Репутация
2,481
Yashied [?]
А на какой уже стадии?
Кстати, можно с таким же успехом перевести заголовки всех функций и сгенерировать справку, но некоторые значения конечно трогать нельзя, иначе придётся и в скрипте править.
 
Автор
Yashied

Yashied

Модератор
Команда форума
Глобальный модератор
Сообщения
5,379
Репутация
2,724
Ну, теперь вся надежда на Garrett'а.

:smile:
 

Garrett

Модератор
Локальный модератор
Сообщения
3,999
Репутация
967
Yashied сказал(а):
Garrett сказал(а):
Правда, я делаю на русском...

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

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



Добавлено:
Сообщение автоматически объединено:

CreatoR [?]
Кстати, можно с таким же успехом перевести заголовки всех функций...
CreatoR
Нет, нет! Здесь IMHO не нужен перевод!
 

CreatoR

Must AutoIt!
Команда форума
Администратор
Сообщения
8,671
Репутация
2,481
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
; ===============================================================================================================================



Добавлено:
Сообщение автоматически объединено:

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

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

AZJIO

Меценат
Меценат
Сообщения
2,874
Репутация
1,194
CreatoR
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
CreatoR сказал(а):
В папку рядом с «AutoIt3Help.exe» помещаем файл «WinAPIEx.chm» (наш файл справки), сам файл «AutoIt3Help.exe» переименовываем в «~AutoIt3Help.exe», и пишем в этой же папке следующий скрипт:
Я недавно всё обгуглил, нигде не нашёл AutoIt3Help.exe, и в установленном SciTE4AutoIt3 у меня нет AutoIt3Help.exe. Может кто нибудь выложит?

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

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