Page 10 of 12

Re: Энциклопедия: улучшение раздела о макросах

Posted: Thu 20 Jan, 2011 00:14
by John Doe

Latest post of the previous page:

Также отсутствуют callplugin(), mmode(2,), window.scroll().
Не описана работа с "точными строками" (verbatim strings).

Re: Энциклопедия: улучшение раздела о макросах

Posted: Thu 20 Jan, 2011 00:18
by Raistlin
John Doe wrote:Я против, т.к. это не даёт общей картины, и создаёт впечатление будто в разных функциях элементы могут нумероваться по-разному.
Это энциклопедия, а не беллетристика. Общая картина не должна быть превалирующей, важнее дать точные и исчерпывающие данные по конкретному интересующему вопросу. Если после ознакомления с конкретной статьей осталась необходимость в экспериментах - статья написана плохо.
John Doe wrote:Все элементы в макроязыке, вообще все, за исключением строк, нумеруются с единицы.
Стоки являются единственным исключением, это на мой взгляд ничем не оправданно, и лишь способствует путанице.
Оправдано, не оправдано - сейчас уже без разницы. Есть объективная реальность: в одних функциях так, в других - так. Поэтому рассуждения про "все элементы" - это демагогия, до которой читающему энциклопедию дела нет.

Re: Энциклопедия: улучшение раздела о макросах

Posted: Thu 20 Jan, 2011 00:30
by John Doe
Raistlin wrote:Если после ознакомления с конкретной статьей осталась необходимость в экспериментах - статья написана плохо.
© Если статью написать так, чтобы она была понятна и идиоту, то только идиот её и захочет прочитать.
Raistlin wrote:...это демагогия, до которой читающему энциклопедию дела нет.
© Резкость суждений суть признак незрелости.
Я почему-то воздержался от подобных характеристик в сторону ваших излияний.

Re: Энциклопедия: улучшение раздела о макросах

Posted: Thu 20 Jan, 2011 00:47
by Raistlin
John Doe wrote:Если статью написать так, чтобы она была понятна и идиоту, то только идиот её и поймёт (с).
Не знаю, чей это (c), но его истинность позволю себе поставить под сомнение. Еще аргументы против исчерпывающей инфы для каждой функции есть?
John Doe wrote:
Raistlin wrote:...это демагогия, до которой читающему энциклопедию дела нет.
Резкость суждений суть признак незрелости (с).
Я почему-то воздержался от подобных характеристик в сторону ваших излияний.
Принимаю любые характеристики - главное, пусть они имеют под собой основания. И свою тоже готов обосновать. Откуда следует, что
Все элементы в макроязыке, вообще все, за исключением строк, нумеруются с единицы.
? Особенно учитывая, что во всех функциях, вообще во всех, работающих с панелями, без всяких исключений, нумерация панелей начинается с нуля.

Интересно было бы узнать мнение других по вопросу: "куда писать про общие вещи", ибо фундаментальный.

Re: Энциклопедия: улучшение раздела о макросах

Posted: Thu 20 Jan, 2011 00:55
by Maximus5
Ну, мне кажется, что

Code: Select all

S=substr(V,N1[,N2]) Возвращает подстроку из выражения V начиная с позиции N1 (начиная с 0) длиной N2.
все-же более удобно для восприятия, нежели "Замечание" где-то на странице.

Re: Энциклопедия: улучшение раздела о макросах

Posted: Thu 20 Jan, 2011 05:00
by Kildor
> Это энциклопедия, а не беллетристика. Общая картина не должна быть превалирующей, важнее дать точные и исчерпывающие данные по конкретному интересующему вопросу. Если после ознакомления с конкретной статьей осталась необходимость в экспериментах - статья написана плохо.
Полностью поддерживаю.
Если какие-то функции ведут себя +/- одинаково, но при этом слегка разно, необходимо в каждой функции писать особенность её поведения — именно в каждой. Особенно, если таки появится индекс всех функций.

Re: Энциклопедия: улучшение раздела о макросах

Posted: Tue 17 May, 2011 09:04
by Raistlin
В раздел про print() предлагаю добавить:
Примечание: функция игнорирует режим замены, всегда работает в режиме вставки.

Энциклопедия: улучшение раздела о макросах

Posted: Sat 25 Nov, 2017 17:16
by John Doe
Предлагаю актуализированный кусок документации о макросах, из Энциклопедии (src).
Прошу заинтересованных проверить на отсутствие ошибок.

Принимаются советы и пожелания.

Однозначно требуется помощь по стилям.
Визуально сейчас главная проблема в представлении definition lists.
Я конечно скопипастил что-то из сети, но результат неудовлетворительный: есть наложения
текста столбцов.

Однако специалист нужен.

Задачи на будущее:
  • Избавиться от дико вложенных описаний.
    Полагаю, для сложных функций надо создать отдельные статьи.
    Возможно это надо сделать вообще для всех элементов (не уверен).
  • Определиться со структурой, и интегрировать с macroapi_manual, добавив также и
    оставшуюся документацию из Энциклопедии
  • Гиперссылки на элементы.
  • Привести в порядок стили.
  • Конвертировать в hlf
  • ???

Энциклопедия: улучшение раздела о макросах

Posted: Sat 25 Nov, 2017 18:00
by Shmuel
Работа проделана немалая, но смотрится на данный момент не очень. Действительно нужен специалист.

Энциклопедия: улучшение раздела о макросах

Posted: Sun 26 Nov, 2017 17:19
by John Doe
Наложения текста исправлены

Энциклопедия: улучшение раздела о макросах

Posted: Sun 26 Nov, 2017 22:42
by John Doe
Попробовал скрестить со стилем github.

Может понадобиться очистка кэша.

Энциклопедия: улучшение раздела о макросах

Posted: Sun 26 Nov, 2017 22:50
by Shmuel
John Doe wrote: Sun 26 Nov, 2017 22:42Попробовал скрестить со стилем github.
Стало намного лучше (на мой субъективный взгляд).
Что не нравится - в подсветке Lua идентификаторы слишком бледные (комменты - и то намного ярче).

Энциклопедия: улучшение раздела о макросах

Posted: Mon 27 Nov, 2017 21:02
by John Doe
Исправил

Энциклопедия: улучшение раздела о макросах

Posted: Mon 27 Nov, 2017 23:12
by sToLp
А нельзя ли в web`овской версии примеры ещё и файлом приаттачить?
Для удобства и чтобы избежать сбоев при копи-пасте.

Энциклопедия: улучшение раздела о макросах

Posted: Tue 28 Nov, 2017 08:45
by John Doe
sToLp wrote: Mon 27 Nov, 2017 23:12чтобы избежать сбоев при копи-пасте
Не должно быть никаких сбоев.

А идея может и неплохая, думал об этом. Но не всё однозначно.
Логично если каждый пример можно скачать отдельно, особенно учитывая что они не только на странице примеров.
И тут мне пока не очень понятно, как это должно выглядеть. Тупо ссылка "скачать" возле каждого мне кажется несколько уродливо.

И другой момент это соотношение с макросами из Addons, которые сейчас отдельно, а неплохо бы всё это хозяйство как-то объединить..

Энциклопедия: улучшение раздела о макросах

Posted: Wed 29 Nov, 2017 14:00
by sToLp
John Doe wrote: Tue 28 Nov, 2017 08:45И другой момент это соотношение с макросами из Addons, которые сейчас отдельно, а неплохо бы всё это хозяйство как-то объединить..
Если макросы с примерами будут помещаться вот хоть в отдельную подпапку Addons, то и надобности прикреплять их к странице сайта не будет. А лишь привести информацию о том, где их можно взять.