Версія Праекта

Возьмем у якасці прыкладу дэманстрацыйны праект:

en/demo2/v - нумар бягучай версіі праекта, які будзе адлюстроўвацца справа ад назвы праекта ў контуры бакавой панэлі.

Тут en/ - гэта код мовы, які адпавядае зыходнай мове перакладу, настроенай .i18n/conf.yml .

Калі ваша зыходная мова не англійская, то файл v павінен быць змешчаны ў каталог праекта вашай зыходнай мовы.

Магчымасць прагляду гістарычных версій дакументаў знаходзіцца ў распрацоўцы.

Рэкамендуецца змяняць нумар версіі дакумента толькі пры выхадзе асноўных абнаўленняў (напрыклад, v1 , v2 ), каб пазбегнуць занадта вялікай колькасці нумароў версій, якія выклікаюць беспарадак на старонках, індэксаваных пошукавымі сістэмамі.

Выкарыстоўвайце Пустыя Файлы v , Каб Падзяліць Індэксы Файлаў Розных Праектаў

У дэманстрацыйным праекце, у дадатак да en/demo2/v , вы таксама можаце ўбачыць, што ёсць пустыя файлы v у каталогах en/blog і en/demo1 .

Пусты v не будзе адлюстроўвацца ў контуры бакавой панэлі, але пакуль ёсць файл v , для файлаў у каталогу і падкаталогах будзе створаны незалежны індэкс.

Падзяляючы індэксы розных праектаў, вы можаце пазбегнуць павольнага доступу, выкліканага загрузкай індэкса ўсіх файлаў на ўсім сайце адначасова.

Напрыклад, індэксны файл, які адпавядае blog у дэманстрацыйным праекце, гэта https://unpkg.com/i18n.site/en/blog.json :