Порядочная нумерация в страницах русско&

[NikLok]

http://www.zabbix.com/documentation/...config/actions
http://www.zabbix.com/documentation/...on_from_source
Часто разделы пронумерованы некорректно.
Например 4 вместо 4.1
В результате страница последняя во втором разделе!
Хочется давно это поправить уже!
Кто из админом могет?

[zalex_ua]

Часто разделы пронумерованы некорректно.
Например 4 вместо 4.1
В результате страница последняя во втором разделе!

Ваш верный слуга (переводчик-проверяющий и не только) на месте .
Вы бы знали сколько сил и времени было убито на исследование истинной причины этих явлений и поиска оптимального их решения.
Вот здесь мною описано умозаключение.
Вместе с этим был вот этот пост на блоге и вот тема обсуждения всего этого.

Вот здесь зафиксировано соглашение о том как это будет в документации 2.0 и там главы не будут скакать. Но и такой "глобальной, наследуемой и сквозной" нумерации глав на одной общей странице как было раньше уже не будет. Но это маленькая потеря мне кажется.


Вот куски переписки на эту тематику с одним из разрабов Richlv:

zalex, 31.10.2010 14:56:37:
mybe it better Numbering by folder level to write manualy? for example   ===== 4. Configuration =====  instead of   ===== - #4 Configuration =====

zalex, 31.10.2010 14:57:26:
this is resolve major problem - unpredictability

zalex, 31.10.2010 17:09:23:
heh.   After several days of deliberation ... I've added here the link   http://www.zabbix.com/documentation/ru/1.8/complete    to my Zabbix monitoring system :-D Update Interval - 10 minutes. Get a page of approximately 1.3 MB, sorry :).

zalex, 31.10.2010 17:09:29:
The greater the interval the greater the likelihood that either a user clicks on the final page(s), when the TTL of the page(s) cache has already ended, and my Zabbix server is not poll "complete" page and does not create the correct cache.

zalex, 31.10.2010 17:09:35:
In theory this will keep the cache in a state where the numbers in the headings are ultimately inherited from the parent to the child. Look in during the day(s) (60*60*24) What is the difference compared with the English version.

zalex, 10.11.2010 22:54:35:
he-he. after 8 days my web-check (docu cache refresh) returned to OK state, i.e. all pages in Config RU section are numbered as like 4.6.  But bottom line is that this is all the toys, not serious. I think that at folder level we just need to write a number. Like "===== 4. Configuration ====="

zalex, 11.11.2010 12:47:31:
about dokuwiki cache. we can make sheduled oparation with two steps:
1. delete all *.i and *.xhtml files from ./cache directory and all subdirectories. I've already explored this behavior (plugin Cache/Revisions Eraser helped me).
2. immediately wget http://www.zabbix.com/documentation/1.8/complete
As result cashe will be builded right way.
Shedule this script every 24hours.

правда же мой английский "изящный" ?

В результате всех этих моих мучений появилась прикольная статья на блоге.

И все это делалось ради вас всех коллеги.

Хочется давно это поправить уже!
Кто из админом могет?

Да самого уже достало тоже иногда искать нужную страницу. В принципе и ветку 1.8 можно переделать и сейчас, у меня были такие мысли но это нужно согласовать с разработчиками. Займусь этим завтра.

p.s. ... а еще была история с таблицами

[NikLok]

Спасибо за обстоятельный ответ!
Немного (вернее много) удручает состояние русской документации по версии 2. Всего 2! раздела! Я понимаю, что там будет практически перепечатка из 1.8, но может уже сделать симлинки с подсветкой (адаптированна по 2.0 или нет)? И честно говоря мне иногда хочется что бы могло быть в дереве раскрыто несколько плюсиков. Например для быстрого перемещения между одинаковыми разделами в 1.8 и 2.0. Ну или волшебную кнопку показывающие различия по сравнению с версией х.у.

[zalex_ua]

Спасибо за обстоятельный ответ!

После потраченой уймы времени на это, вспомнить о немного описать процесс оказалось даже приятно.

Немного (вернее много) удручает состояние русской документации по версии 2. Всего 2! раздела!

А на других языках как дела? Не пробовали сравнить?
Да, их пока всего два (созданы мною). Я ощущаю что на нынешней стадии торопится их создавать будет нерационально. Я слежу за изменениями в английской документации 2.0 и могу сказать что они там регулярные и довольно интенсивные. Поддерживать актуальный перевод нелегко. Я почувствую когда и какие статьи в английской версии устаканятся и будет смысл их переводить на русский. Пока это рано. Да есть цель чтобы к выходу релиза 2.0 русская документация была выпущена одновременно или с небольшой задержкой. Примечание здесь объясняет состояние дел и процесс.

Я понимаю, что там будет практически перепечатка из 1.8, но может уже сделать симлинки с подсветкой (адаптированна по 2.0 или нет)? И честно говоря мне иногда хочется что бы могло быть в дереве раскрыто несколько плюсиков. Например для быстрого перемещения между одинаковыми разделами в 1.8 и 2.0. Ну или волшебную кнопку показывающие различия по сравнению с версией х.у.

Да, практически перепечатка, но будет много изменений и придется все сравнивать посторочно так сказать "вручную глазами", так как по дифам (пример) проверка будет не эффективной и будет порождать возникновение ошибок. Так что кусок работы предстоит еще конкретный.

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


Если вы не безразличны к этому процессу и имеете желание помочь - присоединяйтесь !. Помощь всегда приветствуется.
Добавлю лишь что я не один, переводчики представлены здесь.

[zalex_ua]

Согласование еще в процессе, а пока в качестве эксперимента кое что было изменено, но только в одном месте и только в русской ветке доки.

Вот здесь сравните как в этой ветке выглядит дерево нижестоящих страниц в русской доке по сравнению с английской (селектор удобного выбора языка размещен вверху страницы).

Выражайте свое мнение господа.

[NikLok]

О! Просто замечательно, наконец-то разделы идут по порядку!
Вот еще бы загадочную главу 8 почитать! Или это только для особо приближенных? );

[zalex_ua]

О! Просто замечательно, наконец-то разделы идут по порядку!

Хорошо, будем использовать этот фидбек как аргумент для убеждения в принятии решения.

Вот еще бы загадочную главу 8 почитать! Или это только для особо приближенных? );

Да нет ничего скрытого - это я говорю уверенно.
Я не могу сказать с уверенностью, но думаю что глава под №8 просто была удалена после "рефакторинга" он-лайн документации на стадии ее создания. Я №8 и не помню.
Кстати это можно будет и исправить.