Учествујте

Драго нам је да видимо да доприносите Zammad-у! Можете помоћи на неколико начина. Доприноси се углавном обављају тако што се један од наших репозиторија на GitHub-у форкује и направи pull request са вашим изменама (осим за преводе, погледајте испод за детаље). 🚀

Можете допринети:

• Изворном коду
• Документацији
• Преводу

Погледајте наш одељак како можете да допринесете. Све репозиторије можете пронаћи на GitHub-у.

Zammad изворни кoд

Изворни код Zammad-а можете пронаћи на GitHub-у у Zammad репозиторијуму. Прочитајте уџбеник за програмере за почетак.

Подржани огранци/верзије

GitHub репозиторијум Zammad-а има неколико огранака:

develop

• Ово је тренутно (необјављено) развојно стање следећег већег издања (постаће нови stable огранак).
• Не користите у продукцији!
• Овај огранак има активну подршку и добија редовне исправке грешака и сигурносних пропуста (погледајте безбедносну полису за детаље).

stable

• Ово је тренутно стабилно издање, нпр. Zammad 5.2.
• Користите овај огранак за инсталације у продукцији.
• Овај огранак има активну подршку и добија редовне исправке грешака и сигурносних пропуста (погледајте безбедносну полису за детаље).

stable-x.y

• Ово су огранци старих Zammad издања као stable-5.1 за Zammad 5.1.
• Не користите у продукцији!
• Исправке грешака и сигурносних пропуста се не примењују на ове огранке.

Документација

Документација коју читате је доступна под zammad.org и next.zammad.org и направљена је у Vitepress систему. Изворне датотеке су написане у Markdown формату. Обратите пажњу да мењате само изворне датотеке на енглеском језику које су под /src/en/ директоријумом. Преводи се обрађују преко Weblate апликације и преписаће све измене направљене под директоријумима специфичних језика (осим /src/en/).

Отворите нови GitHub pull request на https://github.com/zammad/zammad-org (заснован на develop огранку) са вашим изменама и обавезно испратите водич кроз стил и садржај. Узмите у обзир и инструкције у README.md датотеци репозиторија.

Превод

Уколико желите да нам помогнете са преводом и побољшате вишејезичну подршку у Zammad-у и/или документацији, ваш допринос је добродошао! Превод самог Zammad-а и документације обавља се преко Weblate апликације, која представља сервис за колаборацију на преводима пројеката. Једноставно посетите Zammad-ову Weblate инстанцу. Можете или отворити налог (ако га већ немате) или се пријавити својим Github налогом!

Представићемо неке основне кораке у следећим одељцима како бисте могли да започнете са превођењем. Међутим, уколико желите да користите напредне Weblate функције и да дубље уђете у проблематику, њихова званична документација вам може помоћи.

Основе

Превод Zammad-а и документације су раздвојени у различите пројекте у Weblate апликацији. Преглед пројеката можете пронаћи кликом на мени при врху под „Projects > Browse all projects”:

Структура пројекта превода у Weblate-у:

• Документација
  • Нова документација на next.zammad.org
  • Нова документација на next.zammad.org
• Zammad
  • Zammad (develop, развојна верзија)
  • Zammad (stable верзија)
  • Додатне верзије које овде нису релевантне

TIP

Одлука у ком огранку желите да преводите не прави велику разлику. Када Weblate детектује идентичне низове текста у различитим огранцима, користиће исти превод за све огранке и тиме се преводи само једном. Уколико нисте сигурни, одаберите develop верзију.

По одабиру пројекта (Documentation или Zammad), видећете више подпројеката и њихов сажети статус превода по свим језицима. Овде можете одабрати једну од „компонената”, које су мање или више идентичне различитим верзијама. По одабиру једне од њих, можете видети статус превода по различитим језицима, по узору на следећи снимак екрана:

Превођење

По одабиру вашег језика на који желите да преводите, добра почетна тачка је одабир „Untranslated strings” (или слично значење у вашем језику, у зависности који језик сте подесили у свом профилу). Након тога, коначно ћете видети први непреведени текст у горњем пољу и, теоретски, можете започети превод. Али хајде да прво погледамо на кратко кориснички интерфејс Weblate-а:

1. Путања навигације на тренутни пројекат и језик превода
2. Сам Translation одељак. Можете видети изворни низ текста („English (United States)”) при врху и поље за унос вашег превода („French” у овом примеру).
3. Glossary: овде можете пронаћи уобичајене у контексту Zammad-а. Термини из речника ће бити наглашени у изворном тексту такође.
4. Неке корисне картице:
   • Nearby strings: вам приказује контекст речи или низа текста
   • Automatic suggestions: овде можете пронаћи аутоматизоване предлоге од DeepL сервиса и предлоге на основу сличног текста, који је већ преведен. Користите дугме „Clone to translation” да убаците текст у поље превода и снимите измене. Користите дугме „Accept” да прихватите предложен предлог и одмах пређене на следећи низ текста.
   • Other languages: овде можете добити преглед који језици већ садрже превод и саме преводе (може бити корисно за сличне језике).

Ознаке у тексту

Испод можете пронаћи пар примера за специјалан текст са примењеним ознакама. У зависности од текста, некад је важно задржати ознаке и/или променљиве. Погледајте и водич кроз стил где можете пронаћи више информација о синтакси и коришћењу Markdown/Vitepress функција.

`пример-текста`

Ово ће бити приказано као пример-текста. У зависности од контекста, ово се може превести или не. У сваком случају, користите ` пре и после низа текста у вашем преводу.

[пример](/en/path/to/document-or-website)

Ово је линк на другу страницу, укључујучи и код језика Текст „пример” изнад биће приказан као текст линка. Овај део можете превести. Што се тиче путање, само замените en са кодом језика на који преводите. Обратите пажњу да ли је ваш језик већ омогућен на zammad.org (проверите преко избора језика). У супротном обратите нам се уколико желите да омогућимо ваш језик.

**пример текста**

Ознака текста (нпр. подебљано, курзив). Алтернатива: _пример текста_. Ови низови текста се могу преводити, али ознаке (нпр. ** ili _) би требало прилагодити правом значењу.