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

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

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

Post by John Doe »

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

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

А по идее ведь и в chm можно сослаться на топик в другом файле...
Shmuel
Posts: 6820
Joined: Thu 23 Mar, 2006 21:36
Location: Israel
Has thanked: 41 times
Been thanked: 528 times

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

Post by Shmuel »

Если вы берётесь затратить время и усилия, то никаких возражений.
User avatar
John Doe
Бюрократ
Posts: 13807
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 73 times
Been thanked: 426 times
Contact:

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

Post by John Doe »

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

Но этого я сделать не могу.
А просто гиперссылки нарисовать - без проблем, сделаю.
Shmuel
Posts: 6820
Joined: Thu 23 Mar, 2006 21:36
Location: Israel
Has thanked: 41 times
Been thanked: 528 times

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

Post by Shmuel »

Это не совсем так прямолинейно. В отличие от Энциклопедии Фара, эти документы имеют исходники в определённом (не HTML) формате.
User avatar
Alexey Samlyukov
Posts: 1765
Joined: Tue 15 Mar, 2005 17:28
Been thanked: 7 times
Contact:

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

Post by Alexey Samlyukov »

можно же вытащить из chm, там-то уж точно есть html-файлы. и оформить их под общее писание. заодно и убрать старый раздел по макрам из писания.
Shmuel
Posts: 6820
Joined: Thu 23 Mar, 2006 21:36
Location: Israel
Has thanked: 41 times
Been thanked: 528 times

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

Post by Shmuel »

Alexey Samlyukov wrote:можно же вытащить из chm, там-то уж точно есть html-файлы. и оформить их под общее писание. заодно и убрать старый раздел по макрам из писания.
1. Можно, но не логично. Редактирование исходников macroapi_manual по сложности соответствует редактированию простого текста, а ручное редактирование HTML - головная боль.
2. Всё равно на данный момент не видно человека, который бы взялся этим заниматься.
User avatar
John Doe
Бюрократ
Posts: 13807
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 73 times
Been thanked: 426 times
Contact:

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

Post by John Doe »

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

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

P.S.
Хотя... по стилю подогнать можно, а как оно генерится никого не интересует.
User avatar
John Doe
Бюрократ
Posts: 13807
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 73 times
Been thanked: 426 times
Contact:

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

Post by John Doe »

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

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

В ночных сборках этого (пока) не будет.
User avatar
John Doe
Бюрократ
Posts: 13807
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 73 times
Been thanked: 426 times
Contact:

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

Post by John Doe »

Собственно чего перестраховываться.
Добавил полную линкификацию.
Неизбежное следствие: могут быть (и обязательно будут) паразитные линки, потому как многие ключевые слова очень просты (типа Menu).
Shmuel
Posts: 6820
Joined: Thu 23 Mar, 2006 21:36
Location: Israel
Has thanked: 41 times
Been thanked: 528 times

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

Post by Shmuel »

С этой экстрой вы перегнули палку: вместо правильного местного линка работает неправильный внешний.
User avatar
John Doe
Бюрократ
Posts: 13807
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 73 times
Been thanked: 426 times
Contact:

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

Post by John Doe »

Да, всё в лоб. Для первичной оценки.
Подкорректирую, но сильно затачивать смысла нет, потому что по-нормальному обрабатывать всё равно надо исходник, а не html
User avatar
John Doe
Бюрократ
Posts: 13807
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 73 times
Been thanked: 426 times
Contact:

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

Post by John Doe »

Работа над ошибками.
Плюс линкифицирована секция WinApi (http://social.msdn.microsoft.com/Search?query=%s)
Shmuel
Posts: 6820
Joined: Thu 23 Mar, 2006 21:36
Location: Israel
Has thanked: 41 times
Been thanked: 528 times

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

Post by Shmuel »

Почему-то линки на WinAPI открываются в браузере, а не в chm.
User avatar
John Doe
Бюрократ
Posts: 13807
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 73 times
Been thanked: 426 times
Contact:

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

Post by John Doe »

Так и задумано, ведь это линк на поиск, там нужны будут дополнительные клики, что в chm уже не очень удобно, и не так просто вернуться к исходной статье.
User avatar
John Doe
Бюрократ
Posts: 13807
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 73 times
Been thanked: 426 times
Contact:

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

Post by John Doe »

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

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

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