--- url: https://next.zammad.org/sr/contribute/contribute.md --- # Учествујте Драго нам је да видимо да доприносите Zammad-у! Можете помоћи на неколико начина. Доприноси се углавном обављају тако што се направи fork једног од наших репозиторија на GitHub-у и отвори pull request са вашим изменама (осим за преводе, погледајте испод за детаље). 🚀 Можете допринети: * [Изворном коду](contribute#zammad-изворни-кoд) * [Документацији](contribute#документација) * [Преводу](contribute#превод) Погледајте наш одељак како можете да допринесете. Све репозиторије можете пронаћи на [GitHub](https://github.com/zammad){target=\_blank}-у. ## Изворни код Zammad-а Изворни код Zammad-а можете пронаћи на GitHub-у у [Zammad репозиторијуму](https://github.com/zammad/zammad){target=\_blank}. Прочитајте [уџбеник за програмере](https://github.com/zammad/zammad/blob/develop/doc/developer_manual/index.md){target=\_blank} за почетак. ### Подржани огранци/верзије GitHub репозиторијум Zammad-а има неколико огранака: #### `develop` * Ово је тренутно (необјављено) развојно стање следећег већег издања (постаће нови `stable` огранак). * Не користите у продукцији! * Овај огранак има активну подршку и добија редовне исправке грешака и сигурносних пропуста (погледајте [безбедносну полису](https://github.com/zammad/zammad/blob/develop/SECURITY.md){target=\_blank} за детаље). #### `stable` * Ово је тренутно стабилно издање, нпр. Zammad 5.2. * Користите овај огранак за инсталације у продукцији. * Овај огранак има активну подршку и добија редовне исправке грешака и сигурносних пропуста (погледајте [безбедносну полису](https://github.com/zammad/zammad/blob/develop/SECURITY.md){target=\_blank} за детаље). #### `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 на (заснован на `develop` огранку) са вашим изменама и обавезно испратите [водич кроз стил и садржај](style-guide). Узмите у обзир и инструкције у [README.md датотеци репозиторија](https://github.com/zammad/zammad-org?tab=readme-ov-file#zammad-hub){target=\_blank}. ## Превод Уколико желите да нам помогнете са преводом и побољшате вишејезичну подршку у Zammad-у или документацији, ваш допринос је добродошао! Превод самог Zammad-а и документације обавља се преко Weblate апликације, која представља сервис за колаборацију на преводима пројеката. Једноставно посетите Zammad-ову [Weblate инстанцу](https://translations.zammad.org/){target=\_blank}. Можете или отворити налог (ако га већ немате) или се пријавити својим Github налогом! Представићемо неке основне кораке у следећим одељцима како бисте могли да започнете са превођењем. Међутим, уколико желите да користите напредне Weblate функције и да дубље уђете у проблематику, њихова [званична документација](https://docs.weblate.org/en/latest/user/translating.html){target=\_blank} вам може помоћи. ### Основе Превод **Zammad-а** и **документације** су раздвојени у различите пројекте у Weblate апликацији. Преглед пројеката можете пронаћи кликом на мени при врху под *Projects > Browse all projects*: ![Снимак екрана који приказује пројекте превода у Weblate менију](/screenshots/contribute/weblate-overview-docs.png) Структура пројекта превода у Weblate-у: * Документација * Нова документација на next.zammad.org * Нова документација на next.zammad.org * Zammad * Zammad (`develop`, развојна верзија) * Zammad (`stable` верзија) * Додатне верзије које овде нису релевантне Одаберите пројекат (документације или Zammad-а) и пређите на језичак **Components**. Одаберите ону коју желите да преведете. Након тога, можете видети статус превода по различитим језицима, по узору на следећи снимак екрана: ![Снимак екрана који приказује статус превода за корисничку документацију по различитим језицима](/screenshots/contribute/weblate-project-overview.png) ::: tip Одлука у ком огранку желите да преводите не прави велику разлику. Када Weblate детектује идентичне низове текста у различитим компонентама користиће исти превод за све огранке и тиме се преводи само једном. Уколико нисте сигурни, одаберите `develop` верзију. ::: ### Превођење Сада проверите „Unfinished” колону вашег језика и кликните на број из ње. Ово ће отворити први непреведен низ текста, и можете започети са преводом. Али прво, кратак преглед корисничког интерфејса Weblate апликације: ![Снимак екрана корисничког интерфејса превода у Weblate-у](/screenshots/contribute/weblate-ui.png) 1. **Путања навигације** на тренутни пројекат, компоненту и језик превода 2. Сам **Translation** одељак. Можете видети изворни низ текста при врху и поље за унос вашег превода испод њега. 3. **Glossary**: када се у низу текста или његовим деловима детектује нешто из речника, овде можете пронаћи додатне информације. Такође, биће назначено у изворном низу текста. 4. **Неке корисне картице**: * **Nearby strings**: вам приказује контекст речи или низа текста * **Automatic suggestions**: овде можете пронаћи аутоматизоване предлоге од DeepL сервиса и предлоге на основу сличног текста, који је већ преведен. Користите дугме `Clone to translation` да убаците текст у поље превода и снимите измене. Користите дугме `Accept` да прихватите предложен превод и одмах пређете на следећи низ текста. * **Other languages**: овде можете добити листу где и како је низ текста преведен на другим језицима (може бити корисно за сличне језике). ### Ознаке у тексту Испод можете пронаћи пар примера за специјалне низове текста са ознаком која индикује где се може пронаћи. Покушајте да задржите (прилагођене) ознаке и променљиве. Одељак **Source string location** у Weblate апликацији (са десне стране) даје вам увид у контекст. Такође, погледајте и [водич кроз стил документације](style-guide) где можете пронаћи више информација о синтакси и коришћењу Markdown/Vitepress функцијама. `%s created ticket |%s|` : Текст садржи променљиве (`%s`) и ознаке (`||`). Обратите пажњу да се променљива и ознаке нађу у преводу. Тачна позиција може зависити од превода. `` `example-string` `` : Ово ће бити приказано као линијски кôд (`example-string`). У зависности од контекста, ово се може превести или не. У сваком случају, користите задње наводнике (`` ` ``) пре и после низа текста у вашем преводу. `[example](/en/path/to/document-or-website)` : Ово је линк на другу страницу, укључујући и код језика. Текст „example” изнад биће приказан као текст линка. Овај део можете превести. Што се тиче путање, само замените `en` са кодом језика на који преводите. Обратите пажњу да ли је ваш језик већ омогућен на zammad.org (проверите преко избора језика). У супротном обратите нам се уколико желите да омогућимо ваш језик. `**пример текста**` : Ознака за текст (нпр. подебљано, курзив). Алтернатива: `_пример текста_`. Начелно задржите ознаке, али их прилагодите тако да значење остане исто.