Urejanje priročnika¶
Priročnik lahko spreminjate tako, da urejate lokalne besedilne datoteke. Te datoteke so usklajene s tistimi na spletu prek repozitorija. Na podlagi tega bo strežnik posodobil spletni priročnik.
The manual is written in the reStructuredText (RST) markup language and can be edited using a plain text editor. For a local preview, you convert (build) the manual source files from RST into HTML web pages.
Posodabljanje¶
Firstly, make sure that your local copy of the manual is up to date with the online repository using:
make update
Pisanje¶
Zdaj lahko z vašim najljubšim urejevalnikom besedila spreminjate dokumentacijske datoteke, torej datoteke .rst v mapi manual.
Be sure to check the Vodič za pisanje for conventions and Oblikovni vodič to learn how to write in the reStructuredText markup language.
Srečno s pisanjem!
Večje spremembe¶
If you are going to add or overhaul a section, be sure to check carefully that it does not already exist. In some places, the docs are so disorganized that sections may be duplicated or in a strange location. In the case that you find a duplicate or out of place section, create an issue explaining the issue, and optionally include a revision (actual changes).
Preden naredite kakršnekoli spremembe, ki niso preproste in jasne (na primer premikanje map), se z vzdrževalcem priročnika posvetujte, ali je vaš prispevek v skladu z vizijo skupnosti. S tem boste najbolje izkoristili čas in dobro voljo, saj se drugače utegne zgoditi, da bodo vaše spremembe iz kakršnega koli razloga navzkriž z drugimi in bodo zavrnjene ali deležne dolgotrajnega pregleda. Na primer, neka druga oseba morda že dela na razdelku, ki ga želite spremeniti, ali pa razdelek morda čaka na izbris ali posodobitev z ozirom na prihajajoče spremembe v Blenderju.
Pravočasna in pogosta :ref:`komunikacija <contribute-contact>`je ključna za produktivno okolje, v katerem se delo članov ne zapravlja in katerega končni rezultat je kakovosten priročnik za Blender.
Dobivanje pomoči ali odgovorov¶
If you are in doubt about functionality that you wish to document,
you should pose your questions to the Blender developers responsible for that area or ask at the unofficial user
support channel in the #docs or #blender-coders channel in Chat.
Blender itself has a system of module owners with developer and artist members who are responsible for the design and maintenance of the assigned Blender areas. See the module pages for more information.
Predogled¶
To view your changes, build the manual as instructed.
Keep in mind that you can also build only the chapter you just edited to view it quickly.
Open the generated .html files inside the build/html folder using your web browser,
or refresh the page if you have it open already.
Nalaganje¶
Ko ste s svojimi spremembami zadovoljni, jih lahko objavite, da bodo vidne na spletnem priročniku. Sprva to počnete tako, da oddate popravke (ang. patches). Tako bo lahko nekdo pregledal vaše spremembe in vam dal povratno informacijo. Kasneje lahko svoje spremembe oddate kar neposredno. Ta proces je podrobno opisan v naslednjem razdelku.