Справка к программе AS Writer v0.2
Основные возможности программы
· Возможность интерпретации SSI, скриптов Perl, PHP, при наличии внешних интерпретаторов.
· Грамотный автоперенос строк при достижении правого края окна редактора.
· Многооконность.
· Модульная архитектура, т.е. возможность добавления любых дополнительных модулей.
· Оптимизатор документов Word.
· Поддержка Unicode.
· Поддержка макросов.
· Подсветка синтаксиса 33 языков программирования + добавление любого количества новых языков..
· Проверка ссылок на их существование.
· Система закладок в тексте.
· Система поиска и замены текста, включая по регулярным выражениям Perl, при этом имеется возможность пакетной замены и поиска текста во внешних файлах.
· Экспорт документов в RTF, HTML, PDF, TeX.
Главное меню программы
|
Пункт меню |
Пункт меню |
Пункт меню |
|
Создать |
Файл |
Создаётся новое пустое окно. |
|
Создать из буфера обмена |
Файл |
Создаётся новое пустое окно с текстом из буфера обмена Windows. |
|
Открыть |
Файл |
Создаётся новое пустое окно, в которое загружается файл, выбранный в появившемся диалоге выбора файлов. |
|
Очистить историю |
Файл |
Удаляется список ранее открытых файлов. |
|
Добавить в избранное |
Файл |
Появляется диалог добавления файла в список избранных документов. |
|
Избранное |
Файл |
Здесь содержится список избранных документов. Для открытия любого из них выберите соответствующий подпункт меню. |
|
Добавить расширение |
Файл |
Появляется диалог добавления расширения. Расширение надо вводить вместе с точкой. |
|
Удалить расширение |
Файл |
Появляется диалог удаления расширения. Расширение надо вводить вместе с точкой. |
|
Установить закладку |
Файл |
Устанавливается закладка в месте расположения курсора. |
|
Перейти к закладке |
Файл |
Осуществляется переход к ранее созданной в тексте закладке. |
|
Сохранить |
Файл |
Если документ, который Вы хотите сохранить, уже был ранее сохранён, то произойдёт его перезапись. Иначе будет предложено его сохранить, под выбранным в диалоге сохранения файла, именем. |
|
Сохранить как… |
Файл |
Появляется диалог сохранения файла, где Вы можете выбрать имя файла, а затем сохранить его под этим именем. |
|
Сохранить всё |
Файл |
Сохранение всех открытых документов. |
|
Экспорт в HTML |
Файл |
Текущий документ экспортируется в HTML. |
|
Экспорт в RTF |
Файл |
Текущий документ экспортируется в RTF. |
|
Экспорт в PDF |
Файл |
Текущий документ экспортируется в PDF. Внимание! Т.к. программа использует незарегистрированную библиотеку pdf.dll, то более 10 страниц за раз экспортировать не удастся. Кроме того, при экспорте возможны проблемы с кириллицей. |
|
Экспорт в TeX |
Файл |
Текущий документ экспортируется в TeX. |
|
Настройки |
Файл |
Появляется диалог выбора основных настроек программы. |
|
Параметры страницы |
Файл |
Появляется диалог выбора параметров страницы. |
|
Предварительный просмотр |
Файл |
Появляется окно предварительного просмотра документа перед печатью. |
|
Печать |
Файл |
Печатается текущий документ. |
|
Выход |
Файл |
Программа отключается без каких-либо проверок. |
|
Отменить |
Правка |
Отменяется последнее выполненное действие. |
|
Вернуть |
Правка |
Возвращается последнее отменённое действие. |
|
Удалить отмены |
Правка |
Очищается буфер отмены. После выполнения этого действия отмену последнего действия сделать невозможно. |
|
Заблокировать отмену |
Правка |
Отмены делать нельзя. |
|
Разблокировать отмену |
Правка |
Отмены делать можно. |
|
Копировать |
Правка |
Выделенный текст копируется в буфер обмена Windows. |
|
Вырезать |
Правка |
Выделенный текст копируется в буфер обмена Windows. При этом выделенный текст стирается. |
|
Вставить |
Правка |
В позицию курсора вставляется текст из буфера обмена Windows. |
|
Выделить всё |
Правка |
Выделяется весь текст. |
|
Скопировать всё |
Правка |
Выделяется и копируется весь текст. |
|
Удалить |
Правка |
Удаляется выделенный текст. |
|
Удалить всё |
Правка |
Удаляется весь текст. |
|
Найти |
Поиск |
Появляется диалоговое окно поиска слова или выражения в тексте. |
|
Найти далее |
Поиск |
Поиск продолжается далее с указанными опциями. |
|
Поиск и замена в файлах |
Поиск |
Появляется диалоговое окно поиска или замены слова или выражения сразу во множестве файлов. |
|
Заменить |
Поиск |
Появляется диалоговое окно замены слова или выражения в тексте. |
|
Перейти к строке |
Поиск |
Появляется диалоговое окно перехода к позиции в тексте. При выборе позиции и нажатии кнопки OK осуществляется переход к выбранной позиции в тексте. |
|
Таблица символов |
Вставка |
Появляется окно выбора специального символа для вставки его в текст. Символы записываются либо в формате HTML, либо в виде обычных символов в тексте, это зависит от настроек программы. |
|
Файл… |
Вставка |
Появляется диалоговое окно выбора файла для его открытия, после чего содержимое выбранного файла вставляется в позицию курсора. |
|
Размер файла |
Вставка |
В текущую позицию курсора вставляется размер выбранного в появившемся диалоге файла. |
|
Специально |
Вставка |
Появляется диалог выбора автотекста, фильтров и др. для вставки в текст. |
|
Дата и время |
Вставка |
В позицию курсора вставляются текущие дата и время. |
|
Дата |
Вставка |
В позицию курсора вставляется текущая дата в выбранном формате. |
|
Время |
Вставка |
В позицию курсора вставляется текущее время в выбранном формате. |
|
Имя файла |
Вставка |
В позицию курсора вставляется краткое имя файла, выбранного в появившемся диалоговом окне открытия файлов. |
|
Полное имя файла |
Вставка |
В позицию курсора вставляется полное имя файла, выбранного в появившемся диалоговом окне открытия файлов. |
|
Имя текущего файла |
Вставка |
В позицию курсора вставляется краткое имя текущего файла. |
|
Полное имя текущего файла |
Вставка |
В позицию курсора вставляется полное имя текущего файла. |
|
Системная папка |
Вставка |
В позицию курсора вставляется путь к системной папке. |
|
Папка Windows |
Вставка |
В позицию курсора вставляется путь к папке Windows. |
|
Временная папка |
Вставка |
В позицию курсора вставляется путь к временной папке Windows. |
|
Текущая папка |
Вставка |
В позицию курсора вставляется путь к текущей рабочей папке. |
|
Пользователь |
Вставка |
В позицию курсора вставляется цвет, выбранный в появившемся диалоговом окне выбора цвета, в формате HTML. |
|
Цвет |
Вставка |
В позицию курсора вставляется имя текущего пользователя, взятое из реестра. |
|
Шрифт листа |
Формат |
Появляется диалог выбора шрифта, в котором Вы можете выбрать параметры шрифта текущего документа. |
|
Шрифт боковой панели |
Формат |
Появляется диалог выбора шрифта, в котором Вы можете выбрать параметры шрифта боковой панели текущего документа. |
|
Оптимизировать |
Формат |
Эта функция позволяет уменьшить размер документа, созданного в Word или в других визуальных редакторах. При этом размер документа сильно уменьшается, а рисунки и форматирование остаётся, в отличие от многих других оптимизаторов. Принцип оптимизации заключается в следующем: из файла combos\optim.lst считываются строки и при нахождении в тексте совпадения с этими строками, совпадение удаляется. Таким образом Вы можете настроить оптимизацию под свой случай, добавляя в указанный файл новые строки, т.е. те строки, которые Вы хотите заменить в тексте нажатием одной этой кнопки. |
|
Изменить строку |
Формат |
Выделите текст. Выберите этот пункт меню. Появляется диалог изменения строки. Введите текст в диалоге, который Вы хотите увидеть перед строкой, затем знак «~», а после этого знака введите то, что Вы хотите увидеть после строки. Например, есть выделенная строка «Привет, как дела?». Нажимаете на кнопку, вводите: «document.writeln('~');». Получается строка «document.writeln('Привет, как дела?');». |
|
Число в формат США |
Формат |
Выделенный текст, если это десятичное число, переводится в формат США. |
|
Удалить лишние пробелы |
Формат |
Все лишние пробелы удаляются из выделенного текста. |
|
Заменить двойные тире |
Формат |
Все двойные тире заменяются одинарными. |
|
Коды в текст |
Формат |
Символы HTML преобразуются в соответствующие им текстовые символы. |
|
Текст в коды |
Формат |
Текст преобразуется в символы HTML. |
|
Текст в HTML |
Формат |
Текст преобразуется в HTML. |
|
HTML в текст |
Формат |
Все теги из HTML удаляются. |
|
Удалять пробелы |
Формат |
Все пробелы из выделенного текста удалются. |
|
Удалять переносы |
Формат |
Все переносы строк из выделенного текста удаляются. |
|
Hex в цвет |
Формат |
Цвет в формате HTML преобразуется в формат редактора. Это нужно, например, чтобы в файлах подсветки менять подсветку. |
|
Теги в верхний регистр |
Формат |
Все теги в выделенном тексте приводятся к верхнему регистру. |
|
Теги в нижний регистр |
Формат |
Все теги в выделенном тексте приводятся к нижнему регистру. |
|
Режим переноса |
Формат |
Существует три режима переноса строк: Dos, Unix, Mac. Все эти режимы применяются в соответсвующих названию операционных системах. При этом изменяется весь текст. |
|
Выделение |
Формат |
Существует три режима выделения текста: нормальное, строка, колонка. |
|
Сортировка |
Формат |
Сортировка выделенного текста по возрастанию или убыванию. |
|
Запуск |
Сервис |
Запуск указанной в диалоге программы или сайта. |
|
Запуск с текущим файлом |
Сервис |
Запуск указанной в диалоге программы или сайта с текущим файлом. |
|
Компилировать |
Сервис |
Компиляция исходного текста в текущем документе. |
|
Обновить подсветку |
Сервис |
Подсветка всех языков обновляется. |
|
Запустить валидатор |
Сервис |
Запускается валидатор XHTML. Чтобы его было видно, надо поставить галочку Вид - Валидатор и снизу потянуть вверх разделитель. |
|
Горячие клавиши |
Сервис |
Появляется диалог настройки горячих клавиш. |
|
Сохранить горячие клавиши |
Сервис |
Все текущие горячие клавиши сохраняются в файл “Hotkeys.ini” и после этого при каждом запуске программы оттуда загружаются. |
|
Календарь |
Сервис |
Появляется окно календаря. |
|
Волшебник CSS |
Сервис |
Появляется диалог создания таблиц CSS. |
|
Генератор таблиц |
Сервис |
Появляется диалог создания таблиц HTML на основе баз данных в формате XML. |
|
Вставить макрос |
Сервис |
В подпунктах этого пункта меню собраны все макросы программы. Просто выберите любой из этих подпунктов и соответствующий макрос будет вставлен в позицию курсора. |
|
Выполнить макросы |
Сервис |
Все макросы запускаются, т.е. активизируются. |
|
Тип проекта |
Сервис |
Появляется диалог выбора проекта при запуске. |
|
Проверить ссылки |
Сервис |
Появляется диалог проверки правильности ссылок. |
|
JavaScript |
Сервис |
Появляется диалог выбора программ на JavaScript. |
Советы
1. Нажатие на F10 приводит к обрамлению выделенного текста кавычками.
2. Программа теперь всегда закрывается без вопросов. Если Вы не сохранили файл заранее, то изменения будут потеряны.
3. Вставить языковую конструкцию можно нажав Ctrl+J. Напишите например arrayd и нажмите эту комбинацию клавиш. Эти списки хранятся в файлах autocomp/*.dci. Выберите Главное меню – Дополнения – Автовставка и выберите нужную автовставку.
Проверка ссылок
При запуске линк-чекера (проверки ссылок) в верхнем окне отображаются все ссылки, присутствующие на текущей странице. При нажатии кнопки "Проверить ссылки" в нижнее окно добавлются все неправильные ссылки, при этом если Вы находитесь в Интернет, то будут проверены и ссылки в сети, если нет – то будут проверены только локальные ссылки. Нажатие кнопки "OK" приводит к закрытию окна.
Валидатор XHTML
Валидатор XHTML - программа проверки документа на его соответствие стандарту XHTML W3C. Если Вы создаёте страницу при помощи XHTML, Вам необходимо проверить её перед тем, как Вы опубликуете эту страницу. Если документ будет признан программой достоверным, значит Ваш документ соответствует стандарту XHTML и Вас можно поздравить. Если же нет - программа укажет Вам проблемные места. И помните - достоверность вашего документа гарантирует то, что он будет правильно отображён всеми браузерами, поддерживающими стандарт XHTML. Валидатор проверяет только XHTML! Он не проверяет CSS, JavaScript, PHP или ещё что-то другое.
Работа с валидатором. Проверка документа на достоверность
Чтобы проверить документ нужно:
· Ваш документ должен иметь вот такой тег вверху страницы: <!DOCTYPE html SYSTEM "xhtml1tr.txt"> либо такой: <!DOCTYPE html SYSTEM "xhtml1st.txt">, а если Ваш документ состоит из фреймов, то такой: <!DOCTYPE html SYSTEM "xhtml1fr.txt">.
· Нажмите "Проверить" в нижнем окошке.
· После этого в том же нижнем окошке появятся сообщения об ошибках в странице. Надо их исправить.
· Документ будет достоверным, когда сообщения об ошибках исчезнут, и в нижнем окошке появится надпись "Ваш документ достоверен!".
Поиск и замена в файлах
При помощи этого инструмента Вы можете искать и заменять текст сразу во многих файлах. Нажмите кнопку “Добавить” для того, чтобы выбрать файлы, либо “Искать файлы” для того, чтобы искать файлы в выбранной папке, включая подпапки. Вы должны указать расширение файлов, которые Вы хотите искать. Все найденные или выбранные файлы будут добавлены в нижнее окно. В левом верхнем окне вам нужно записать текст, который нужно заменить или искать, в правом верхнем окне – текст, которым нужно заменить. Нажатие кнопки “Заменить текст” приводит к замене текста во всех выбранных файлах, нажатие кнопки “Искать текст” приводит к поиску текста в выбранных файлах. Нажатие на кнопку “Очистить” приводит к очистке содержимого окон редактирования. Чтобы закрыть окно расширенного поиска и замены, нажмите “Закрыть”.
Макросы
Макросы служат для удобства работы с программой. Вставить их можно вручную, или выбрав пункт главного меню Сервис – Вставить макрос. Активировать макрос можно, выбрав Сервис – Выполнить макросы.
Список макросов
|
<@date> |
Заменяет все вхождения макроса на текущую дату. |
|
<@username> |
Заменяет все вхождения макроса на имя пользователя. |
|
<@datetime> |
Заменяет все вхождения макроса на текущие дату и время. |
|
<@time> |
Заменяет все вхождения макроса на текущее время. |
|
<@fnprogram> |
Заменяет все вхождения макроса на полное название этой программы. |
|
<@snprogram> |
Заменяет все вхождения макроса на краткое название этой программы. |
|
<@curfile> |
Заменяет все вхождения макроса на полное название текущего файла. |
|
<@scurfile> |
Заменяет все вхождения макроса на краткое название текущего файла. |
|
<@language> |
Заменяет все вхождения макроса на название текущего языка. |
|
<@mail> |
Открывает почтовую программу, чтобы послать письмо автору. |
|
<@www> |
Открывает сайт автора. |
|
<@clearhistory> |
Очищает список истории. |
Плагины
Пользователям.
Плагины находятся в папке “plugins” в папке с программой Amnesia. Они представляют собой обычные библиотеки с расширением .dll. написанные особым образом. Плагины данной программы совместимы с плагинами к программам LidaEd и KoEdit 3.x.
Программистам.
Пример написания плагина.
library del_spaces;
function DelChars(const S: string; Chr: Char): string; // функция преобразования
var
I: Integer;
begin
Result := S;
for I := Length(Result) downto 1 do begin
if Result[I] = Chr then Delete(Result, I, 1);
end;
end;
function GetMenuCaption: PChar; // функция вывода заголовка меню
begin
Result := 'Удалить пробелы';
end;
function GetPluginInfo(ParentHandle: integer;
var Name, Author, Version, Email, Web, AdditionalInfo: PChar
): integer; // функция информации о плагине
begin
Name := 'Удалить пробелы';
Author := 'Алексей Смышляев';
Version := '1.0';
Email := 'alois1981@mail.ru';
Web := 'http://www.alois.com.ru';
AdditionalInfo := 'Удаляются все пробелы в выделенном тексте.';
Result := 0;
end;
function HandleData(ParentHandle : integer;
FileName : PChar;
var SelText, AllText, ErrorText : PChar;
var CaretX, CaretY : integer
) : integer; // главная функция плагина
var
txt: string;
begin
if Length(SelText) = 0 then
begin
ErrorText := PChar('Для выполнения необходимо выделить текст!');
Result := 0;
exit;
end;
txt := SelText;
txt := DelChars(txt, ' ');
getmem(SelText, length(PChar(txt)));
SelText := PChar(txt);
Result := 1;
end;
Создание пользовательской подсветки.
Все файлы подсветки программа ищет в подпапке “userh”. Для каждого языка должно быть два файла. Файлы должны иметь одно название, но расширения должны быть у одного XML, у другого – CFG. В файле CFG хранятся цвета для различных идентификаторов, ключевых слов, комментариев и др. В тегах <comments> устанавливается стиль комментариев – число от 0 до 5. В тегах <deffilter> надо сохранить фильтр для файлов языка. В <detectprep> указывается 0 или -1. 0 означает, что директивы препроцессора не указываются, а -1 что указываются. В <keywords> через пробел указываются все ключевые слова языка. В тегах <stringdelim> указывается стиль кавычек для строк. 0 означает одинарные кавычки, как в Pascal, а 1 – двойные кавычки, как в C++. Корневой элемент XML-документа должен быть <high>.