LuaMacro: улучшение документации
- John Doe
- Бюрократ
- Posts: 13867
- Joined: Wed 27 Apr, 2005 20:42
- Has thanked: 74 times
- Been thanked: 428 times
- Contact:
LuaMacro: улучшение документации
Может пора уже выложить luafar_manual и macroapi_manual на farmanager.com?
Дело вот в чём.
luafar_manual крайне лаконичен, и для его понимания требуется иметь представление о pluginapi_manual.
Перекрёстные ссылки очень способствовали бы.
А по идее ведь и в chm можно сослаться на топик в другом файле...
Дело вот в чём.
luafar_manual крайне лаконичен, и для его понимания требуется иметь представление о pluginapi_manual.
Перекрёстные ссылки очень способствовали бы.
А по идее ведь и в chm можно сослаться на топик в другом файле...
- John Doe
- Бюрократ
- Posts: 13867
- Joined: Wed 27 Apr, 2005 20:42
- Has thanked: 74 times
- Been thanked: 428 times
- Contact:
Re: Spring — внедрение Lua в качестве макроязыка
В идеале нужен скрипт, который по запросу http://api.farmanager.com/?keyword будет выдавать нужную страницу.
Было бы полезно во всех отношениях.
Но этого я сделать не могу.
А просто гиперссылки нарисовать - без проблем, сделаю.
Было бы полезно во всех отношениях.
Но этого я сделать не могу.
А просто гиперссылки нарисовать - без проблем, сделаю.
- Alexey Samlyukov
- Posts: 1765
- Joined: Tue 15 Mar, 2005 17:28
- Been thanked: 7 times
- Contact:
Re: Spring — внедрение Lua в качестве макроязыка
можно же вытащить из chm, там-то уж точно есть html-файлы. и оформить их под общее писание. заодно и убрать старый раздел по макрам из писания.
-
- Posts: 6840
- Joined: Thu 23 Mar, 2006 21:36
- Location: Israel
- Has thanked: 41 times
- Been thanked: 530 times
Re: Spring — внедрение Lua в качестве макроязыка
1. Можно, но не логично. Редактирование исходников macroapi_manual по сложности соответствует редактированию простого текста, а ручное редактирование HTML - головная боль.Alexey Samlyukov wrote:можно же вытащить из chm, там-то уж точно есть html-файлы. и оформить их под общее писание. заодно и убрать старый раздел по макрам из писания.
2. Всё равно на данный момент не видно человека, который бы взялся этим заниматься.
- John Doe
- Бюрократ
- Posts: 13867
- Joined: Wed 27 Apr, 2005 20:42
- Has thanked: 74 times
- Been thanked: 428 times
- Contact:
Re: Spring — внедрение Lua в качестве макроязыка
Никакого нового раздела нет, поэтому старый убирать нельзя.Alexey Samlyukov wrote:заодно и убрать старый раздел по макрам из писания.
Я вообще говорил не о макросах, а о luafar_manual.chm.
И да, стоило бы перевести Писание в markdown, а вовсе не наоборот.
P.S.
Хотя... по стилю подогнать можно, а как оно генерится никого не интересует.
- John Doe
- Бюрократ
- Posts: 13867
- Joined: Wed 27 Apr, 2005 20:42
- Has thanked: 74 times
- Been thanked: 428 times
- Contact:
Re: Spring — внедрение Lua в качестве макроязыка
Прилагаю линкифицированный мануал.John Doe wrote:В идеале нужен скрипт, который по запросу http://api.farmanager.com/?keyword будет выдавать нужную страницу.
Было бы полезно во всех отношениях.
Но этого я сделать не могу.
А просто гиперссылки нарисовать - без проблем, сделаю.
В ночных сборках этого (пока) не будет.
- John Doe
- Бюрократ
- Posts: 13867
- Joined: Wed 27 Apr, 2005 20:42
- Has thanked: 74 times
- Been thanked: 428 times
- Contact:
Re: Spring — внедрение Lua в качестве макроязыка
Собственно чего перестраховываться.
Добавил полную линкификацию.
Неизбежное следствие: могут быть (и обязательно будут) паразитные линки, потому как многие ключевые слова очень просты (типа Menu).
Добавил полную линкификацию.
Неизбежное следствие: могут быть (и обязательно будут) паразитные линки, потому как многие ключевые слова очень просты (типа Menu).
- John Doe
- Бюрократ
- Posts: 13867
- Joined: Wed 27 Apr, 2005 20:42
- Has thanked: 74 times
- Been thanked: 428 times
- Contact:
Re: Spring — внедрение Lua в качестве макроязыка
Да, всё в лоб. Для первичной оценки.
Подкорректирую, но сильно затачивать смысла нет, потому что по-нормальному обрабатывать всё равно надо исходник, а не html
Подкорректирую, но сильно затачивать смысла нет, потому что по-нормальному обрабатывать всё равно надо исходник, а не html
- John Doe
- Бюрократ
- Posts: 13867
- Joined: Wed 27 Apr, 2005 20:42
- Has thanked: 74 times
- Been thanked: 428 times
- Contact:
Re: Spring — внедрение Lua в качестве макроязыка
Работа над ошибками.
Плюс линкифицирована секция WinApi (http://social.msdn.microsoft.com/Search?query=%s)
Плюс линкифицирована секция WinApi (http://social.msdn.microsoft.com/Search?query=%s)
- John Doe
- Бюрократ
- Posts: 13867
- Joined: Wed 27 Apr, 2005 20:42
- Has thanked: 74 times
- Been thanked: 428 times
- Contact:
Re: Spring — внедрение Lua в качестве макроязыка
Так и задумано, ведь это линк на поиск, там нужны будут дополнительные клики, что в chm уже не очень удобно, и не так просто вернуться к исходной статье.
- John Doe
- Бюрократ
- Posts: 13867
- Joined: Wed 27 Apr, 2005 20:42
- Has thanked: 74 times
- Been thanked: 428 times
- Contact:
Re: Spring — внедрение Lua в качестве макроязыка
Обновлённый luafar_manual.chm, "экстра"линки чёрного цвета (легко отличить от обычных)
Плюс линкифицирован macroapi_manual.chm
Update
Более свежая версия в шапках тем:
Плюс линкифицирован macroapi_manual.chm
Update
Более свежая версия в шапках тем: