LuaMacro: улучшение документации

Здесь обсуждается всё, что касается макросов.
User avatar
John Doe
Бюрократ
Posts: 11433
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 17 times
Been thanked: 102 times

LuaMacro: улучшение документации

Post by John Doe » Mon 04 Mar, 2013 17:57

Может пора уже выложить luafar_manual и macroapi_manual на farmanager.com?

Дело вот в чём.
luafar_manual крайне лаконичен, и для его понимания требуется иметь представление о pluginapi_manual.
Перекрёстные ссылки очень способствовали бы.

А по идее ведь и в chm можно сослаться на топик в другом файле...

Shmuel
Posts: 5236
Joined: Thu 23 Mar, 2006 21:36
Location: Israel
Has thanked: 16 times
Been thanked: 152 times

Re: Spring — внедрение Lua в качестве макроязыка

Post by Shmuel » Mon 04 Mar, 2013 18:02

Если вы берётесь затратить время и усилия, то никаких возражений.

User avatar
John Doe
Бюрократ
Posts: 11433
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 17 times
Been thanked: 102 times

Re: Spring — внедрение Lua в качестве макроязыка

Post by John Doe » Mon 04 Mar, 2013 18:10

В идеале нужен скрипт, который по запросу http://api.farmanager.com/?keyword будет выдавать нужную страницу.
Было бы полезно во всех отношениях.

Но этого я сделать не могу.
А просто гиперссылки нарисовать - без проблем, сделаю.

Shmuel
Posts: 5236
Joined: Thu 23 Mar, 2006 21:36
Location: Israel
Has thanked: 16 times
Been thanked: 152 times

Re: Spring — внедрение Lua в качестве макроязыка

Post by Shmuel » Mon 04 Mar, 2013 18:14

Это не совсем так прямолинейно. В отличие от Энциклопедии Фара, эти документы имеют исходники в определённом (не HTML) формате.

User avatar
Alexey Samlyukov
Posts: 1759
Joined: Tue 15 Mar, 2005 17:28
Been thanked: 2 times
Contact:

Re: Spring — внедрение Lua в качестве макроязыка

Post by Alexey Samlyukov » Tue 05 Mar, 2013 02:13

можно же вытащить из chm, там-то уж точно есть html-файлы. и оформить их под общее писание. заодно и убрать старый раздел по макрам из писания.

Shmuel
Posts: 5236
Joined: Thu 23 Mar, 2006 21:36
Location: Israel
Has thanked: 16 times
Been thanked: 152 times

Re: Spring — внедрение Lua в качестве макроязыка

Post by Shmuel » Tue 05 Mar, 2013 05:35

Alexey Samlyukov wrote:можно же вытащить из chm, там-то уж точно есть html-файлы. и оформить их под общее писание. заодно и убрать старый раздел по макрам из писания.
1. Можно, но не логично. Редактирование исходников macroapi_manual по сложности соответствует редактированию простого текста, а ручное редактирование HTML - головная боль.
2. Всё равно на данный момент не видно человека, который бы взялся этим заниматься.

User avatar
John Doe
Бюрократ
Posts: 11433
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 17 times
Been thanked: 102 times

Re: Spring — внедрение Lua в качестве макроязыка

Post by John Doe » Tue 05 Mar, 2013 11:21

Alexey Samlyukov wrote:заодно и убрать старый раздел по макрам из писания.
Никакого нового раздела нет, поэтому старый убирать нельзя.
Я вообще говорил не о макросах, а о luafar_manual.chm.

И да, стоило бы перевести Писание в markdown, а вовсе не наоборот.

P.S.
Хотя... по стилю подогнать можно, а как оно генерится никого не интересует.

User avatar
John Doe
Бюрократ
Posts: 11433
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 17 times
Been thanked: 102 times

Re: Spring — внедрение Lua в качестве макроязыка

Post by John Doe » Wed 06 Mar, 2013 14:24

John Doe wrote:В идеале нужен скрипт, который по запросу http://api.farmanager.com/?keyword будет выдавать нужную страницу.
Было бы полезно во всех отношениях.

Но этого я сделать не могу.
А просто гиперссылки нарисовать - без проблем, сделаю.
Прилагаю линкифицированный мануал.

В ночных сборках этого (пока) не будет.

User avatar
John Doe
Бюрократ
Posts: 11433
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 17 times
Been thanked: 102 times

Re: Spring — внедрение Lua в качестве макроязыка

Post by John Doe » Wed 06 Mar, 2013 14:45

Собственно чего перестраховываться.
Добавил полную линкификацию.
Неизбежное следствие: могут быть (и обязательно будут) паразитные линки, потому как многие ключевые слова очень просты (типа Menu).

Shmuel
Posts: 5236
Joined: Thu 23 Mar, 2006 21:36
Location: Israel
Has thanked: 16 times
Been thanked: 152 times

Re: Spring — внедрение Lua в качестве макроязыка

Post by Shmuel » Wed 06 Mar, 2013 14:46

С этой экстрой вы перегнули палку: вместо правильного местного линка работает неправильный внешний.

User avatar
John Doe
Бюрократ
Posts: 11433
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 17 times
Been thanked: 102 times

Re: Spring — внедрение Lua в качестве макроязыка

Post by John Doe » Wed 06 Mar, 2013 14:54

Да, всё в лоб. Для первичной оценки.
Подкорректирую, но сильно затачивать смысла нет, потому что по-нормальному обрабатывать всё равно надо исходник, а не html

User avatar
John Doe
Бюрократ
Posts: 11433
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 17 times
Been thanked: 102 times

Re: Spring — внедрение Lua в качестве макроязыка

Post by John Doe » Thu 07 Mar, 2013 02:05

Работа над ошибками.
Плюс линкифицирована секция WinApi (http://social.msdn.microsoft.com/Search?query=%s)

Shmuel
Posts: 5236
Joined: Thu 23 Mar, 2006 21:36
Location: Israel
Has thanked: 16 times
Been thanked: 152 times

Re: Spring — внедрение Lua в качестве макроязыка

Post by Shmuel » Thu 07 Mar, 2013 13:25

Почему-то линки на WinAPI открываются в браузере, а не в chm.

User avatar
John Doe
Бюрократ
Posts: 11433
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 17 times
Been thanked: 102 times

Re: Spring — внедрение Lua в качестве макроязыка

Post by John Doe » Thu 07 Mar, 2013 13:31

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

User avatar
John Doe
Бюрократ
Posts: 11433
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 17 times
Been thanked: 102 times

Re: Spring — внедрение Lua в качестве макроязыка

Post by John Doe » Mon 11 Mar, 2013 00:46

Обновлённый luafar_manual.chm, "экстра"линки чёрного цвета (легко отличить от обычных)
Плюс линкифицирован macroapi_manual.chm

Update
Более свежая версия в шапках тем:

Shmuel
Posts: 5236
Joined: Thu 23 Mar, 2006 21:36
Location: Israel
Has thanked: 16 times
Been thanked: 152 times

Re: LuaMacro — Lua как язык макросов

Post by Shmuel » Tue 21 Jan, 2014 13:00

John Doe wrote:В разделе мануала Ограничения в использовании некоторых функций упоминается о возможности обхода ограничений с помощью far.MacroPost. Предлагаю добавить туда же упоминание о mf.postmacro
Добавлено.

Post Reply

Return to “Обсуждение макросов”