1 Тема від leofun01 Востаннє редагувалося leofun01 (30.07.2018 07:37:27)

  • leofun01
  • leofun01
  • Replace Team
  • Поза форумом
  • Дата реєстрації: 15.03.2014
  • Повідомлень: 3 272
    • Репутація: 2719

Тема: Як зробити Github Wiki кількома мовами ?

На Github можна створювати сторінки Wiki, в яких можна розмістити детальний опис репозиторію/проекту.
Питання:
Як правильно розмістити опис, коли він перекладений кількома мовами ?

От наприклад є сторінка "Home",
мені в ній розмістити всі мови ? як тут:

Lang:
- [English](#en)
- [Українська](#uk)

<div id="en">
    Some content (en).
</div>

<div id="uk">
    Якийсь контент (uk).
</div>

чи розкинути кожну мову на окрему сторінку ? і з головної ("Home") давати на них посилання ? як тут :

Lang:
- [English](Home-(en))
- [Українська](Home-(uk))

Чи робити багатомовним "README.md" ?
README.md
README.uk.md

Чи багатомовні описи взагалі ніхто не робить ?

Подякували: FakiNyan, NaharD, ostap34PHP3

leofun01 вебсайт

2 Відповідь від leofun01 Востаннє редагувалося leofun01 (01.08.2018 14:21:30)

  • leofun01
  • leofun01
  • Replace Team
  • Поза форумом
  • Дата реєстрації: 15.03.2014
  • Повідомлень: 3 272
    • Репутація: 2719

Re: Як зробити Github Wiki кількома мовами ?

Виявилося, що всі 3 варіанти - це цілком нормально.
Але розміщення всіх мов на одній сторінці годиться тільки у випадках, коли тексту дуже мало.

Найчастіше практикується наступна схема :
Кожна мова розкидується на окремі сторінки і _Sidebar (права панель) містить посилання на сторінки з різними мовами.
_Sidebar теж підтримує markdown, тому гарно його оформити - не проблема.
Шкода, що _Sidebar тільки один для всіх сторінок. Це робить його не дуже зручним для переходів між мовами.

Знайшов кілька прикладів оформлення Wiki (не реклама) :
metamod-r
pythonAPI
shevchenko-js
ArchiSteamFarm

upd:
Я помилився, стосовно єдиного для всіх сторінок _Sidebar.
І як раз тут дуже хороший приклад, як це правильно робити.

upd 2:
Знайшов остаточне підтвердження на користь окремих сторінок. Все, я пішов махатися з GitHub'ом.

Подякували: LoganRoss, P.Y., ReAl3

leofun01 вебсайт