AkelPad

Скачать CHM-справку
Скачать проект для компиляции CHM
Решил попробовать сделать справку
Не знаю осилю ли я. Вместе бы конечно осилили, но в одиночку наверно получится однобоко, то что интересно мне.

1. Хочу переделать списки параметров в таблицу.
2. Хочу подсветить код.
3. Хочу чекбоксы, кнопки (элементы окна) сделать как здесь.

AZJIO
Я понимаю, что "дураку половину работы не показывают", но какова конечная цель? Скрипты переаннотировать?

Замечание по технической части:
Крайне желательно делать скриншоты с нетюнингованных форм. Чтобы пользователь видел форму такой, какая она есть в стандартной поставке. (пример)(пример)

У вас, в FindReplaceEx.ini установлен параметр

Code: Select all

bGoToDlg=false;

поэтому отсутствует ссылка на форму "Перейти".

Замечание по содержательной части:
Кнопочки и таблички - это хорошо (наверное), и/или, как минимум, красиво. Но пока я вижу, что технический перевод - это не ваша сильная сторона. А неправильный перевод иной раз хуже чем никакого. Так не разумнее ли оставить оригинальный текст? Это и быстрее будет.

opk44 wrote:Скрипты переаннотировать?

Ты наверно будешь удивлён что из 10 или из 100 или даже из 1000 (на сколько сих хватит) опрошенных не знают английский, поэтому при всеобщей бы казалось очевидности (типа мы думаем что все знают англ.), ты заставляешь всех использовать гугл и конечно он переводит лучше чем последовательность "гугл (+M$) потом я".

opk44 wrote:Крайне желательно делать скриншоты с нетюнингованных форм

Можно и с нетюнингованных, если знать что это тюнингованый.

opk44 wrote:А неправильный перевод иной раз хуже чем никакого.

я как то пробовал делать автоматизацию перевода гуглом с последующей обработкой скриптами, для восстановления тегов и я находил это удобным, терялась вязкость, даже если перевод был кривой, то по смыслам слов и знаний где гугл лажает смысл восстанавливался и наоборот, даже если ты знаешь 90% (технических) слов без гугла, допустим айтем, гаджет, шуд, эрэй, то оставшиеся 10% создают тупик, ещё раз повторю, если знаешь 90% (технических), в чём я сомневаюсь если вы опросите 1000 человек. Конечно если переводить с тестом, то есть перепробуешь все параметры чтобы восстановить картину, то да, ты будешь отвечать за каждое слово, но и в этом случае находятся люди, которые упорно используют английский вариант и с удовольствием рассказывают это тебе, намекая, что всё равно в переводе может быть допущена ошибка, которая исключается оригиналом, пока я не докажу сколько тысяч ошибок я выявил переводя и тестируя. Но на тесты в данный момент у меня нет времени. А у вас наверно хватает времени вместо одного раза объяснять каждому новому зарегистрированному новичку одно и тоже, возможно здесь кроется удовольствие тыкать носом.

opk44 wrote:Так не разумнее ли оставить оригинальный текст?

Вязкость является проблемой. Если ты начинаешь дело и количество телодвижений является велико по отношению к потенциалу продвижения, то хочется бросить и сделать что-то более интересное. Чтобы не отталкивать вязкостью, нужно сделать получение результата за минимальное количество шагов/телодвижений. Оставляя как есть вы перекладываете работу перевода на каждого новичка с использованием гугла. Не проще ли если работу сделает один человек вместо количества русскоязычных зарегистрированных на сайте? Количество человеко-часов в последнем случае пропорционально числу людей.

староестарое

Доделал описание Coder::Settings - Пункт в меню: "Плагины - Программирование - Настроить"
Добавил описание "Параметры".
Добавил описание "Переменные стиля", типа HighLight_AutoMarkFlags и т.д.

Обновил, в "Методы" сделал параметры в виде таблицы. То есть написал au3-функцию преобразования в таблицу. Скрипты выложил в архиве, если кто захочет поиграться.

Добавил подсветку примеров для раздела "Методы AkelPad", который появился ранее экспортированием из Scripts-Rus.txt в html.
Обработка выполняется только в CHM-файле с чёрной темой. Пока лень стили подгонять для белой темы.
Перезалил, исправил - не работало копирование иконкой напротив кода примера.

Для TabSwitch.js нужен перевод для

-CtrlTab=false -No Ctrl+Tab hotkey is assigned to TabSwitch.js (default is true).

разница - при false выпадает список, при true нет

Нужно пояснение к

-RightLeft=true -Switch between tabs: Left-Right. Default is false - switch between tabs: Next-Previous.

Лево-право по расположению в окне, а следующая предыдущая по индексу? или по очереди выбора?

Обновил
Добавил Плагины-Coder-Folds, насколько удалось разобраться в теме

мысли в слух:
если же под chm необходимо верстать htm-странички может лучше заморочиться созданием справки в формате портабельного веб-офлайн сайта. И тогда каждый сможет скопировать себе справку на локалку (или просто в каталог ПК) и полистать. а более продвинутые даже внести свой вклад в апгрейд мануала

Open-Source так Open-Source, а то получается ставишь AP из побуждений открытого кода и потом в довесок ещё ставить различные апликации. Как то не комильфо получается что ли...

Eskander88
Не понял идею! Справка легко распаковывается (7zip) и компилируется (компилятор со справкой). Нет преграды для внесения своего вклада.
Что за различные апликации? Справка что-ли? Кто-то запрещает помогать её совершенствовать? Продавать я её не буду после того как ты поможешь, так что можешь добавлять контент.

Обновил
Проверил орфографию, исправил 23 ошибки.
На страницу "коллекция скриптов" сделан прыжок к именам и обратно.
В дереве плаг Coder теперь раскрывается.
Несколько поправок всвязи с тем что узнал новые вещи.
Исправил пути на открытия плаг-Rus.txt, проблема что при открытии справки из AkelPad рабочая папка становится AkelPad и пути из справки не работали. На данный момент из AkelPad работают, а при открытии из проводника не работают, но я открываю из AkelPad поэтому приоритет такой.

В AkelPad уже есть инструкция в формате html. Не проще ли прикрутить все возможности chm-справки с помощью js-скриптов. Таким образом развивая и консолидируя всю нужную инфу вокруг корневого документа. Какой принципиальный плюс chm-файла? Разве, что поиск по материалам каталога, ну и опять же всякие фичи, которые также реализованы через скрипты.

Один из самых неприятных моментов работы с AkelPad это отсутствие систематизированной справки. Инфа разбросана то там, то сям. Бывает надо сделать какой-то маленький функционал на коленке, и вроде помнишь, что был образец по тому или иному методу, - но не можешь сообразить в какой ветке это зарыто. Да и не поймёшь в какую ветку залазить, ибо многие моменты на мой взгляд разрознены. Должна быть всё такие единая консолидированная справочная система.

Eskander88

Должна быть всё такие единая консолидированная справочная система

Это я и делаю. Можешь присоединяться и тоже делать. Любой перевод популярных скриптов, описание какого либо функционала интересного многим на твой взгляд.

Какой принципиальный плюс chm-файла?

Древовидная структура. То есть если раздел скрипты, то там будут скрипты и всё что с этим связано. Человек решивший изучать скрипты не будет вынужден выискивать контент на одной большой простыне, а сразу будет ограничен тем материалом который он хочет изучить.

Ну и поиск в chm работает.

VladSh
На html тоже поиск работает, поэтому эту фичу нельзя назвать особенностью. В теории можно всю справку сделать на одной странице и в заголовке сделать якорные ссылки на разделы, а в разделах якорные ссылки на подразделы. То есть оформить всё на одной странице и пользоваться поиском по странице. Но меня такой формат не устраивает, в том числе и грузится эта страница будет дольше.

AZJIO wrote:Древовидная структура. То есть если раздел скрипты, то там будут скрипты и всё что с этим связано. Человек решивший изучать скрипты не будет вынужден выискивать контент на одной большой простыне.

AZJIO, по поводу древовидной иерархической структуры согласен. Однако этот момент тоже решаем в html с помощью iframe-ов или иным способом. Вот кстати, лаконичный пример html-ки справки с древовидной системой в боковой навигационной панели: https://www.elma-bpm.ru/KB/article-5260.html

AZJIO wrote: Можешь присоединяться и тоже делать. Любой перевод популярных скриптов, описание какого либо функционала интересного многим на твой взгляд.

Да с радостью бы, где бы только ещё взять энерджайзер на все дела, задумки и успевать ещё основную работу сдавать )))

Eskander88
Я не знаю на чём это сделано, вроде на js-скриптах, так как я слышал что есть ещё дерево на php. На js-скриптах ранее я использовал этот движок, но он сильно зависим от того как ты его выкладываешь, в CHM или онлайн на сайте. И когда мне казалось что я его подстроил на сайте, он потом криво работал, то есть когда по ссылке переходишь внутри контента, то можно потерять дерево. А также его тяжело обновлять, там было дерево в словаре и я писал скрипт для генерации дерева, а когда надо было добавить страницу, то в нескольких местах там вспоминаешь куда вставлять. В общем морока которая отнимает только время. И кстати с переездом ресурса "народ" на "юкоз" всё это стало поломанным самим "юкоз". Смотри тут, там в заголовке есть текст "Открыть документацию в виде дерева:" и это не работает, исходники у меня конечно есть.
А на счёт генерации обычного дерева в виде html c ul, то у меня написан скрипт, которые генерирует и дерево и алфавитный указатель из TOC, тут проблем нет и я это уже выложил вроде выше в ссылках.

Да с радостью бы, где бы только ещё взять энерджайзер

что за энерджайзер? Почему у меня получается без него?