Учествујте
Драго нам је да видимо да доприносите Zammad-у! Можете помоћи на неколико начина. Доприноси се углавном обављају тако што се направи fork једног од наших репозиторија на 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верзија) - Додатне верзије које овде нису релевантне
- Zammad (
Одаберите пројекат (документације или Zammad-а) и пређите на језичак Components. Одаберите ону коју желите да преведете. Након тога, можете видети статус превода по различитим језицима, по узору на следећи снимак екрана:
TIP
Одлука у ком огранку желите да преводите не прави велику разлику. Када Weblate детектује идентичне низове текста у различитим компонентама користиће исти превод за све огранке и тиме се преводи само једном. Уколико нисте сигурни, одаберите develop верзију.
Превођење
Сада проверите „Unfinished” колону вашег језика и кликните на број из ње. Ово ће отворити први непреведен низ текста, и можете започети са преводом. Али прво, кратак преглед корисничког интерфејса Weblate апликације:
- Путања навигације на тренутни пројекат, компоненту и језик превода
- Сам Translation одељак. Можете видети изворни низ текста при врху и поље за унос вашег превода испод њега.
- Glossary: када се у низу текста или његовим деловима детектује нешто из речника, овде можете пронаћи додатне информације. Такође, биће назначено у изворном низу текста.
- Неке корисне картице:
- Nearby strings: вам приказује контекст речи или низа текста
- Automatic suggestions: овде можете пронаћи аутоматизоване предлоге од DeepL сервиса и предлоге на основу сличног текста, који је већ преведен. Користите дугме
Clone to translationда убаците текст у поље превода и снимите измене. Користите дугмеAcceptда прихватите предложен превод и одмах пређете на следећи низ текста. - Other languages: овде можете добити листу где и како је низ текста преведен на другим језицима (може бити корисно за сличне језике).
Ознаке у тексту
Испод можете пронаћи пар примера за специјалне низове текста са ознаком која индикује где се може пронаћи. Покушајте да задржите (прилагођене) ознаке и променљиве. Одељак Source string location у Weblate апликацији (са десне стране) даје вам увид у контекст. Такође, погледајте и водич кроз стил документације где можете пронаћи више информација о синтакси и коришћењу Markdown/Vitepress функцијама.
%s created ticket |%s|Zammad- Текст садржи променљиве (
%s) и ознаке (||). Обратите пажњу да се променљива и ознаке нађу у преводу. Тачна позиција може зависити од превода. `example-string`Documentation- Ово ће бити приказано као линијски кôд (
example-string). У зависности од контекста, ово се може превести или не. У сваком случају, користите задње наводнике (`) пре и после низа текста у вашем преводу. [example](/en/path/to/document-or-website)Documentation- Ово је линк на другу страницу, укључујући и код језика. Текст „example” изнад биће приказан као текст линка. Овај део можете превести. Што се тиче путање, само замените
enса кодом језика на који преводите. Обратите пажњу да ли је ваш језик већ омогућен на zammad.org (проверите преко избора језика). У супротном обратите нам се уколико желите да омогућимо ваш језик. **пример текста**Documentation- Ознака за текст (нпр. подебљано, курзив). Алтернатива:
_пример текста_. Начелно задржите ознаке, али их прилагодите тако да значење остане исто.