Translate /doc/wiki-style-guide.md in sr
translation completed updated for the source file '/doc/wiki-style-guide.md' on the 'sr' language.
This commit is contained in:
transifex-integration[bot]
GitHub
parent
5d175b5841
commit
f67283e007
|
|
@ -20,11 +20,13 @@ tags: документација, вики
|
||||||
Активни глас оставља читаоцу утисак да аутор стоји иза написаног дела.
|
Активни глас оставља читаоцу утисак да аутор стоји иза написаног дела.
|
||||||
|
|
||||||
#### Избегавај Пасивни глас осим уколико није неопходан
|
#### Избегавај Пасивни глас осим уколико није неопходан
|
||||||
* Пасивни глас * је граматички потпуно исправан, али представља препреку читаочевом разумевању.
|
Пасивни глас * је граматички потпуно исправан, али представља препреку читаочевом разумевању.
|
||||||
|
|
||||||
Пасивни глас врти се око конвенционалне реченице. Она помера глагол и усмерава предмет према првој половини реченице, а главни тему поставља у другу половину реченице. Често једноставно реструктурирање реченице чини је активном.
|
Пасивни глас врти се око конвенционалне реченице. Она помера глагол и усмерава предмет према првој половини реченице, а главни тему поставља у другу половину реченице. Често једноставно реструктурирање реченице чини је активном.
|
||||||
|
|
||||||
Дуге пасивне реченице често траже више читања пре него што читалац схвати потпуно значење.
|
Дуге пасивне реченице често траже више читања пре него што читалац схвати потпуно значење.
|
||||||
|
|
||||||
`АКТИВАН: Изаберите јаку лозинку да би унапредили личну сигурност.`
|
#### `АКТИВАН: Изаберите јаку лозинку да би унапредили личну сигурност.`
|
||||||
|
|
||||||
`ПАСИВАН: Лична сигурност се унапређује избором јаке лозинке.`
|
`ПАСИВАН: Лична сигурност се унапређује избором јаке лозинке.`
|
||||||
|
|
||||||
|
|
@ -51,15 +53,15 @@ tags: документација, вики
|
||||||
Изаберите речи након што размотрите што је више могуће случајева. На пример, „иди на“ није тако прецизно као „кликни“, али „кликни“ можда није тачно за све интеракције интерфејса. Израз "изабери" је тачан у сваком случају употребе и довољно прецизан.
|
Изаберите речи након што размотрите што је више могуће случајева. На пример, „иди на“ није тако прецизно као „кликни“, али „кликни“ можда није тачно за све интеракције интерфејса. Израз "изабери" је тачан у сваком случају употребе и довољно прецизан.
|
||||||
Не будите преокупирани покушајем да покријете све могуће случајеве употребе. Покривање ретких споредних случајева продужава документ без разлога, а читалац губи фокус.
|
Не будите преокупирани покушајем да покријете све могуће случајеве употребе. Покривање ретких споредних случајева продужава документ без разлога, а читалац губи фокус.
|
||||||
|
|
||||||
#### Временско стање
|
## Временско стање
|
||||||
|
|
||||||
Временско стање је оно време у коме се дешава радња.
|
### Временско стање је оно време у коме се дешава радња.
|
||||||
Постоје три главна времена: прошлост, садашњост и будућност. Изаберите одговарајуће временско стање за документ и примените га на документ.
|
Постоје три главна времена: прошлост, садашњост и будућност. Изаберите одговарајуће временско стање за документ и примените га на документ.
|
||||||
За техничку документацију, треба користити садашње стање када год је то могуће.
|
За техничку документацију, треба користити садашње стање када год је то могуће.
|
||||||
Одражавање истог стања за сваку тврдњу у документу је од виталног значаја за јасноћу.
|
Одражавање истог стања за сваку тврдњу у документу је од виталног значаја за јасноћу.
|
||||||
Задржите исто стање за све редне задатке у поступку.
|
Задржите исто стање за све редне задатке у поступку.
|
||||||
|
|
||||||
## Употреба
|
Употреба
|
||||||
|
|
||||||
### Скраћивање
|
### Скраћивање
|
||||||
|
|
||||||
|
|
@ -67,22 +69,22 @@ tags: документација, вики
|
||||||
Скраћивања смањују читљивост докумената и отежавају превођење.
|
Скраћивања смањују читљивост докумената и отежавају превођење.
|
||||||
Друге културе и језици различито тумаче скраћивања, а ова конфузија у сукобу је са циљевима Пројекта документације за OpenMandriva.
|
Друге културе и језици различито тумаче скраћивања, а ова конфузија у сукобу је са циљевима Пројекта документације за OpenMandriva.
|
||||||
|
|
||||||
### Заменице
|
Заменице
|
||||||
|
* Заменице су речи који језик користи да би замени одређени именични израз.
|
||||||
Заменице су речи који језик користи да би замени одређени именични израз.
|
|
||||||
Добри писци морају погодити баланс између преише понављање именичних фраза, и коришћење заменица које замењују именице. Опште правило за очување јасноће је да никада не треба понављати замену именице са заменицом у две узастопне реченице.
|
Добри писци морају погодити баланс између преише понављање именичних фраза, и коришћење заменица које замењују именице. Опште правило за очување јасноће је да никада не треба понављати замену именице са заменицом у две узастопне реченице.
|
||||||
Читаоци техничке документације требају стално подсећање на праву тему о којој аутор пише. Претерано коришћење заменица може узроковати да читаоци погађају тему на коју реченица упућује.
|
Читаоци техничке документације требају стално подсећање на праву тему о којој аутор пише. Претерано коришћење заменица може узроковати да читаоци погађају тему на коју реченица упућује.
|
||||||
Ове претпоставке умањују ефикасност документа.
|
Ове претпоставке умањују ефикасност документа.
|
||||||
|
* Избегавајте личне заменице у документацији, укључујући следеће:
|
||||||
Избегавајте личне заменице у документацији, укључујући следеће:
|
|
||||||
* Субјектне личне заменице ("Ја," "он," "она," "то," "ми,")
|
* Субјектне личне заменице ("Ја," "он," "она," "то," "ми,")
|
||||||
* Објектне личне заменице ("мени," "њој," "њему," "нама")
|
|
||||||
* Присвојне личне заменице ("моје," "њено," "његово," "наше")
|
|
||||||
|
|
||||||
Такође избегавајте:
|
Објектне личне заменице ("мени," "њој," "њему," "нама")
|
||||||
|
* Присвојне личне заменице ("моје," "њено," "његово," "наше")
|
||||||
|
* Такође избегавајте:
|
||||||
* Друге личне заменице попут "себи" or "собом"
|
* Друге личне заменице попут "себи" or "собом"
|
||||||
* Друге личне заменице попут "он сам" или "(ти) уради то сам"
|
|
||||||
* Одуприте се претераном коришћењу "ти", "твој", и "један/нечији"
|
Друге личне заменице попут "он сам" или "(ти) уради то сам"
|
||||||
|
|
||||||
|
Одуприте се претераном коришћењу "ти", "твој", и "један/нечији"
|
||||||
|
|
||||||
Повремено ситуације захтевају другу личну заменицу "ви" и њене пратеће форме због јасноће.
|
Повремено ситуације захтевају другу личну заменицу "ви" и њене пратеће форме због јасноће.
|
||||||
Одржавање активног гласа је најважније преко избегавање других личних заменица. "Ви" и "ваше" су одговарајуће речи које означавају радњу или поседовање са стране читаоца.
|
Одржавање активног гласа је најважније преко избегавање других личних заменица. "Ви" и "ваше" су одговарајуће речи које означавају радњу или поседовање са стране читаоца.
|
||||||
|
|
@ -96,37 +98,36 @@ tags: документација, вики
|
||||||
Када елиминишете неодређене заменице, гломазна дуга реченица може бити резултат придруживања превише чланова.
|
Када елиминишете неодређене заменице, гломазна дуга реченица може бити резултат придруживања превише чланова.
|
||||||
Употребите неодређене заменице да бисте раздвојили дуге реченице ради побољшања јасноћe, али увек осигурајте одговарајући претходни члан.
|
Употребите неодређене заменице да бисте раздвојили дуге реченице ради побољшања јасноћe, али увек осигурајте одговарајући претходни члан.
|
||||||
|
|
||||||
`НЕИСПРАВНО: Останите у току са препорученим надоградњама вашег оперативног система да бисте побољшали функционалност
|
### `НЕИСПРАВНО: Останите у току са препорученим надоградњама вашег оперативног система да бисте побољшали функционалност
|
||||||
апликација, уклоните сигурносне ризике и аутоматски решите проблеме са перформансама које су решени на основу извештаја о грешкама.`
|
апликација, уклоните сигурносне ризике и аутоматски решите проблеме са перформансама које су решени на основу извештаја о грешкама.`
|
||||||
|
|
||||||
`ИСПРАВНО: Останите у току са препорученим надоградњама вашег оперативног систем. Ове надоградње унапређују функционалност
|
`ИСПРАВНО: Останите у току са препорученим надоградњама вашег оперативног систем. Ове надоградње унапређују функционалност
|
||||||
апликација, уклања сигурносне ризике, и аутоматски режава проблеме са перформансама који су речени на основу извештаја о грешкама.`
|
апликација, уклања сигурносне ризике, и аутоматски режава проблеме са перформансама који су речени на основу извештаја о грешкама.`
|
||||||
|
|
||||||
### Формирање реченице
|
#### Формирање реченице
|
||||||
|
|
||||||
Задржите реченице што је краћим могуће.
|
Задржите реченице што је краћим могуће.
|
||||||
Избацивање непотребних речи је од пресудног значаја за ојачање значења.
|
Избацивање непотребних речи је од пресудног значаја за ојачање значења.
|
||||||
Постоји одређени број уобичајених замки у које упадају креатори техничке документације што доводи до дугачких реченица.
|
Постоји одређени број уобичајених замки у које упадају креатори техничке документације што доводи до дугачких реченица.
|
||||||
|
|
||||||
#### Индиректан говор
|
Индиректан говор
|
||||||
|
|
||||||
Идиректан говор се односи на употребу "то" као прилога тврдњи, чињеници, или осећају у реченици без употребе наводника.
|
Идиректан говор се односи на употребу "то" као прилога тврдњи, чињеници, или осећају у реченици без употребе наводника.
|
||||||
У уобичајеном писању, оно слаби изјаву чињенице.
|
У уобичајеном писању, оно слаби изјаву чињенице.
|
||||||
Писци документације могу унапредити утица реченице уклањањем "то" и "које".
|
Писци документације могу унапредити утица реченице уклањањем "то" и "које".
|
||||||
|
|
||||||
`НЕИСПРАВНО: Mandriva је оперативни систем отвореног кода који је покретач за многе друге пројекте отвореног кода.`
|
#### `НЕИСПРАВНО: Mandriva је оперативни систем отвореног кода који је покретач за многе друге пројекте отвореног кода.`
|
||||||
|
|
||||||
`ИСПРАВНО: Mandriva је покретачки оперативни систем отвореног кода за многе друге пројекте отвореног кода.`
|
`ИСПРАВНО: Mandriva је покретачки оперативни систем отвореног кода за многе друге пројекте отвореног кода.`
|
||||||
|
|
||||||
#### Остале непотребне комбинације речи
|
Остале непотребне комбинације речи
|
||||||
|
|
||||||
Избегавајте непотребу реч "тада" које прати тврдња "уколико".
|
Избегавајте непотребу реч "тада" које прати тврдња "уколико".
|
||||||
Када реченице почињу са тврдњом "уколико", коју прати зарез и цела реченица са комплетном тврдњом.
|
Када реченице почињу са тврдњом "уколико", коју прати зарез и цела реченица са комплетном тврдњом.
|
||||||
|
|
||||||
`НЕИСПРАВНО: уколико клијент ел.поште не шаље или не прима поруке, тада кликните на Мени Фајл и проверите да ли је "Рад без мреже" деселектован.`
|
`НЕИСПРАВНО: уколико клијент ел.поште не шаље или не прима поруке, тада кликните на Мени Фајл и проверите да ли је "Рад без мреже" деселектован.`
|
||||||
|
|
||||||
`ИСПРАВНО: Уколико клијент ел.поште неће да шаље и прима поруке, проверите у менију Фајл и проверите да ли је "Рад без мреже" деселектован.`
|
#### `ИСПРАВНО: Уколико клијент ел.поште неће да шаље и прима поруке, проверите у менију Фајл и проверите да ли је "Рад без мреже" деселектован.`
|
||||||
|
|
||||||
Многе речи које користимо у свакодневној конверзацији умањују утицај штампаних материјала зато што "остављају излаз напоље".
|
Многе речи које користимо у свакодневној конверзацији умањују утицај штампаних материјала зато што "остављају излаз напоље".
|
||||||
Ово су речи које стоје испред глагола и именица ради умањења значаја реченице. Ово није преобина листа, али пажљиви писци документације ће умањити коришћење тих речи и других сличне природе.
|
Ово су речи које стоје испред глагола и именица ради умањења значаја реченице. Ово није преобина листа, али пажљиви писци документације ће умањити коришћење тих речи и других сличне природе.
|
||||||
|
|
||||||
|
|
@ -135,25 +136,24 @@ tags: документација, вики
|
||||||
Друге речи такође могу упасти у ову категорију, али ова кратка листа има за циљ да помогне писцу документације да утврди речи ове природе и уклони их из свог писања: ** треба, може, може бити, могуће, можда, неки, многи, већина, бројни, неколико, понешто, донекле, шта год, по могућности, може повремено и често**.
|
Друге речи такође могу упасти у ову категорију, али ова кратка листа има за циљ да помогне писцу документације да утврди речи ове природе и уклони их из свог писања: ** треба, може, може бити, могуће, можда, неки, многи, већина, бројни, неколико, понешто, донекле, шта год, по могућности, може повремено и често**.
|
||||||
|
|
||||||
#### Промене реченице
|
#### Промене реченице
|
||||||
|
|
||||||
За највећи значај, задржите прву и последњу реченицу у параграфу што је краћом могуће.
|
За највећи значај, задржите прву и последњу реченицу у параграфу што је краћом могуће.
|
||||||
Мењањем дужине реченице у параграфу и кроз цео документ држи пажњу читаоца. Кратка и једноставна чињеница се лако прихвата и користи за анализу теме следеће реченице. Не постији ништа погрешно у коришћењу дуже реченице ради објашњења сложене идеје или концепта. Покушајте да користите једноставне реченице на крају сваког параграфа да би читаоу дали могућност да обухвати све битне информације.
|
Мењањем дужине реченице у параграфу и кроз цео документ држи пажњу читаоца. Кратка и једноставна чињеница се лако прихвата и користи за анализу теме следеће реченице. Не постији ништа погрешно у коришћењу дуже реченице ради објашњења сложене идеје или концепта. Покушајте да користите једноставне реченице на крају сваког параграфа да би читаоу дали могућност да обухвати све битне информације.
|
||||||
Кратка последња реченица остаје са читаоцем за следећу секцију.
|
Кратка последња реченица остаје са читаоцем за следећу секцију.
|
||||||
|
|
||||||
#### Велика слова
|
Велика слова
|
||||||
|
|
||||||
У реченицама, велико слово треба ставити у прво реч-
|
У реченицама, велико слово треба ставити у прво реч-
|
||||||
Не почињите реченице са командом, пакетом или опционим именом.
|
Не почињите реченице са командом, пакетом или опционим именом.
|
||||||
|
|
||||||
`НЕИСПРАВНО: <code>smolt</code> омогућава профилисање хардвера.`
|
#### `НЕИСПРАВНО: <code>smolt</code> омогућава профилисање хардвера.`
|
||||||
|
|
||||||
`ИСПРАВНО: Пакет <code>smolt</code> омогућава профилисање хардвера.`
|
`ИСПРАВНО: Пакет <code>smolt</code> омогућава профилисање хардвера.`
|
||||||
|
|
||||||
#### Знакови интерпукције
|
Знакови интерпукције
|
||||||
|
* Интерпукција је најбитнија компонента за разумевање написаног.
|
||||||
Интерпукција је најбитнија компонента за разумевање написаног.
|
|
||||||
Лоше постављен, зарез, тачка зарез или неправилно коришћење знакова интерпукције може потпуно променити значење реченице. Интерпукцијске ознаке су затварачи у пишчевом алату. Читаоци су навикнути на уобичајене ознаке, попут зареза или три тачке, а мање познате ознаке лако скрећу пажњу читаоцима.
|
Лоше постављен, зарез, тачка зарез или неправилно коришћење знакова интерпукције може потпуно променити значење реченице. Интерпукцијске ознаке су затварачи у пишчевом алату. Читаоци су навикнути на уобичајене ознаке, попут зареза или три тачке, а мање познате ознаке лако скрећу пажњу читаоцима.
|
||||||
Сложене интерпукцијске ознаке нису универзалне, и отежавају напоре за превођење OpenMandriva документације.
|
Сложене интерпукцијске ознаке нису универзалне, и отежавају напоре за превођење OpenMandriva документације.
|
||||||
|
|
||||||
Смањите употребу следећих интерпукцијских ознака у документацији:
|
Смањите употребу следећих интерпукцијских ознака у документацији:
|
||||||
* Заграде или црте
|
* Заграде или црте
|
||||||
Ради замене, промените редослед реченице, или је раздвојите у две целине
|
Ради замене, промените редослед реченице, или је раздвојите у две целине
|
||||||
|
|
@ -167,10 +167,14 @@ tags: документација, вики
|
||||||
У техничком писању они су прихватљиви само за коришћење последње решење за навођење "упозорења", не за наглашавање
|
У техничком писању они су прихватљиви само за коришћење последње решење за навођење "упозорења", не за наглашавање
|
||||||
* Знак &
|
* Знак &
|
||||||
Реч "и" треба написати, а овај знак користити само уколико је део рачунарске команде
|
Реч "и" треба написати, а овај знак користити само уколико је део рачунарске команде
|
||||||
* Косе црте
|
|
||||||
|
## Косе црте
|
||||||
|
|
||||||
Немојте користити косе црте за скраћивање попут "он или она" коришћењем он/она уместо речи "и", "или" или "ни". Косе црте се често користе у путањама фајлова и њихово коришћење у друге сврхе може направити конфузију
|
Немојте користити косе црте за скраћивање попут "он или она" коришћењем он/она уместо речи "и", "или" или "ни". Косе црте се често користе у путањама фајлова и њихово коришћење у друге сврхе може направити конфузију
|
||||||
|
|
||||||
## Друга питања везана за писање
|
Друга питања везана за писање
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
Сваки писац наиђе на препреке у писању. Постаје тешко адекватно формулисати нешто или речи једноставно не звуче исправно.
|
Сваки писац наиђе на препреке у писању. Постаје тешко адекватно формулисати нешто или речи једноставно не звуче исправно.
|
||||||
Због тога је Опенмандрива пројекат тимски напор. Позовите колеге писце документације на листи за слање или цхат соби за помоћ у вези са формулацијама и проблемима у формату.
|
Због тога је Опенмандрива пројекат тимски напор. Позовите колеге писце документације на листи за слање или цхат соби за помоћ у вези са формулацијама и проблемима у формату.
|
||||||
|
|
@ -179,16 +183,10 @@ tags: документација, вики
|
||||||
Општи циљ документационог пројекта OpenMandriva је пружање помоћи корисницима ОpenMandriva на лако разумљивом језику.
|
Општи циљ документационог пројекта OpenMandriva је пружање помоћи корисницима ОpenMandriva на лако разумљивом језику.
|
||||||
Не морате писати да бисте импресионирали професора енглеског језика или показали своју стручност у вези са неком темом. Кратке реченице, честе дефиниције нових и непознатих термина, као и референтне везе, су помоћ која наша публика највише цени.
|
Не морате писати да бисте импресионирали професора енглеског језика или показали своју стручност у вези са неком темом. Кратке реченице, честе дефиниције нових и непознатих термина, као и референтне везе, су помоћ која наша публика највише цени.
|
||||||
Пишите имајући на уму циљану публику, и то ће бити ваши доприноси у документацији са највећим бројем посета корисника којима је потребан одговор.
|
Пишите имајући на уму циљану публику, и то ће бити ваши доприноси у документацији са највећим бројем посета корисника којима је потребан одговор.
|
||||||
|
## *Заслуге:
|
||||||
|
|
||||||
|
|
||||||
*Заслуге:
|
|
||||||
Преузето iz* [Стилски водич Fedora пројекта](http://Fedoraproject.org/wiki/Docs_Project_Style_Guide_-_General_Guidelines)
|
Преузето iz* [Стилски водич Fedora пројекта](http://Fedoraproject.org/wiki/Docs_Project_Style_Guide_-_General_Guidelines)
|
||||||
|
|
||||||
----
|
----
|
||||||
## Посебни стилски водич OpenMandriva викија
|
|
||||||
|
|
||||||
Прочитајте и [Посебни стилски водич OpenMandriva викија](/en/doc/omawiki-style-guide)
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue