Правила обязательного оформления публикаций

[`p r o x y]

Правила обязательного оформления публикаций

Внимание!
Эти правила применяются касательно текущего раздела, и его подраздела «UDF - Пользовательские функции».

1. Каждое сообщение должно начинаться с шапки вида:

Тема: UDF Computer Info

AutoIt: 3.2.1.2 - 3.3.0.0
Версия: 00.03.08
Категория:
Описание: Получение информации о компьютере и его устройствах используя WMI.
Код: Пример

Спойлер

#include "CompInfo.au3" ;If you are wanting to pull WMI data from different computers then Declare $cI_CompName as the computer name before the include.

#region -- Boot Configuration
Dim $BootConfig

_ComputerGetBootConfig($BootConfig)
If @error Then
    $error = @error
    $extended = @extended
    Switch $extended
        Case 1
            _ErrorMsg($ERR_NO_INFO)
        Case 2
            _ErrorMsg($ERR_NOT_OBJ)
    EndSwitch
EndIf

For $i = 1 To $BootConfig[0][0] Step 1
    MsgBox(0, "Test _ComputerGetBootConfig", "Name: " & $BootConfig[$i][0] & @CRLF & _
            "Boot Directory: " & $BootConfig[$i][1] & @CRLF & _
            "Configuration Path: " & $BootConfig[$i][2] & @CRLF & _
            "Last Drive: " & $BootConfig[$i][3] & @CRLF & _
            "Description: " & $BootConfig[$i][4] & @CRLF & _
            "Scratch Directory: " & $BootConfig[$i][5] & @CRLF & _
            "Setting ID: " & $BootConfig[$i][6] & @CRLF & _
            "Temp Directory: " & $BootConfig[$i][7])
Next
#endregion Boot Configuration

#region ---- Internal Functions
Func _ErrorMsg($message, $time = 0)
    MsgBox(48 + 262144, "Error!", $message, $time)
EndFunc
#endregion Internal Functions

Файл: (UDF) Computer Info.zip
Снимок: N/A

История версий:

v1.0
* Первый релиз.

Источник: http://www.autoitscript.com/forum/index.php?showtopic=29404
Автор(ы): JSThePatriot

2. Префикс: категория публикуемоего скрипта / приложения.

3. Тема: ёмкое, описывающее суть выполняемой задачи скрипта / название приложения.

4. Икона сообщения:
- AutoIt Script, если публикуется скрипт;
- Executable, если публикуется только EXE файл / стороннее приложение.

5. Если обнаружили ошибки, устаревшие данные, новые версии, - пожалуйста, сообщите об этом, нажав на ссылку «Сообщить модератору».

AutoIt (только для AutoIt скриптов)
Поддерживаемая версия(и) AutoIt, как минимум та, под которой тестировался скрипт.

Версия (если есть)
Версия публикуемого скрипта назначенная разработчиком / Версия приложения.

Категория
Одна из следующих, или на своё усмотрение, в зависимости от специфики скрипта / приложения:

Администрирование
Автоматизация
Вспомогательные функции
Графика
GDI+
Строки
Данные
База данных
Интеракция
Интернет
Кодирование
Шифрование
Командная строка
Математика
Мышь
Клавиатура
Приколы
Процессы
Сеть
Система
Реестр
Окна и диалоги
Файловая система
Хуки
Элементы GUI
Разное

Описание (опционально)
Описание выполняемой задачи, принцип работы.

Код (только для AutoIt скриптов, если есть)
1. Код должен содержать менее 500 строк, в противном случае прикреплять только файл.
2. Код публиковать: желательно обрамлённый тегом [autoit][/autoit], но обязательно проверенный, работоспособный и выровненный утилитой Tidy.
3. Код, содержащий более 30 строк, обрамлять тегом: [spoiler][/spoiler].
4. Если публикуется UDF, то необходимо опубликовать её исходный код и отдельно исходный код примера работы с этой UDF.

Файл (прикрепить, или загрузить (только для AutoIt скриптов) на файловый-хостинг)
1. Файл с исходным кодом скрипта. Если нет исходного кода, то исполняемый файл (EXE).
2. Если публикуется UDF, то необходимо прикрепить файл её исходного кода и отдельный файл исходного кода примера работы с этой UDF.
3. Если публикуется стороннее приложение, то опубликовать прямую ссылку на закачку приложения и ссылку, если есть, на страницу закачки.
3. Название файла должно совпадать с названием скрипта (включая префикс «[Script]» / «[Wrapper]» / «[Compiled]»).
3. Если прикрепляемых файлов больше одного, то файлы необходимо заархивировать.

Снимок (опционально)
Публикуемые изображения размещать на сторонних ресурсах.
Варианты WEB ресурсов, на которых бесплатно без регистрации можно разместить изображения:

http://ipicture.ru/
http://radikal.ru/
http://sharepix.ru/
http://paintedover.com/
http://tinypic.com/
http://imageshack.us/
http://saveimg.ru/

История версий
Если имеется, то история версия в порядке убывания (последняя в начале).

Источник
Ссылка на источник. Если неизвестно, либо нигде ранее не публиковалось, пишите http://autoit-script.ru.

Автор(ы)
Имя / ник автора.


BB Шаблон шапки:

[b]AutoIt:[/b] 
[b]Версия:[/b]
[b]Категория:[/b] 
[b]Описание:[/b] 

[b]Код:[/b] 

[b]Файл:[/b] [url=][/url]
[b]Снимок:[/b] [url=ссылка на изображение][IMG]ссылка на изображение[/IMG][/url]

[b]История версий:[/b]

[b]Источник:[/b] [url=][/url]
[b]Автор(ы):[/b]

[NEW] Для автоматизации форматирования шаблона, была специально создана утилита «Генератор заголовка тем».
И если этого мало, то в этом разделе также используется готовый шаблон при создании новой темы