# Slovenian translation for gtk-doc. # Copyright (C) 2010 gtk-doc's COPYRIGHT HOLDER # This file is distributed under the same license as the gtk-doc package. # # FIRST AUTHOR , YEAR. # msgid "" msgstr "" "Project-Id-Version: gtk-doc help master\n" "POT-Creation-Date: 2024-03-14 14:02+0000\n" "PO-Revision-Date: 2024-03-30 18:39+0100\n" "Last-Translator: Martin Srebotnjak \n" "Language-Team: Slovenian GNOME Translation Team \n" "Language: sl_SI\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Plural-Forms: nplurals=4; plural=(n%100==1 ? 1 : n%100==2 ? 2 : n%100==3 || n" "%100==4 ? 3 : 0);\n" "X-Poedit-SourceCharset: utf-8\n" "X-Generator: Poedit 2.2.1\n" #. Put one translator per line, in the form NAME , YEAR1, YEAR2 msgctxt "_" msgid "translator-credits" msgstr "" "Matej Urbančič \n" "Martin Srebotnjak " #. (itstool) path: bookinfo/title #: C/index.docbook:12 msgid "GTK-Doc Manual" msgstr "Priročnik GTK-Doc" #. (itstool) path: bookinfo/edition #: C/index.docbook:13 msgid "1.24.1" msgstr "1.24.1" #. (itstool) path: abstract/para #: C/index.docbook:14 msgid "User manual for developers with instructions of GTK-Doc usage." msgstr "Uporabniški priročnik za razvijalce z navodili za uporabo GTK-Doc." #. (itstool) path: authorgroup/author #: C/index.docbook:16 msgid "" "Chris Lyttle " "
chris@wilddev.net
" msgstr "" "Chris Lyttle " "
chris@wilddev.net
" #. (itstool) path: authorgroup/author #: C/index.docbook:25 msgid "" "Dan Mueth
" "d-mueth@uchicago.edu
" msgstr "" "Dan Mueth
" "d-mueth@uchicago.edu
" #. (itstool) path: authorgroup/author #: C/index.docbook:34 msgid "" "Stefan Sauer (Kost) " "
ensonic@users.sf.net
" msgstr "" "Stefan Sauer (Kost) " "
ensonic@users.sf.net
" #. (itstool) path: publisher/publishername #: C/index.docbook:45 msgid "GTK-Doc project" msgstr "Projekt GTK-Doc" #. (itstool) path: bookinfo/publisher #: C/index.docbook:44 msgid "" "<_:publishername-1/>
gtk-doc-list@gnome.org
" msgstr "" "<_:publishername-1/>
gtk-doc-list@gnome.org
" #. (itstool) path: bookinfo/copyright #: C/index.docbook:48 msgid "2000, 2005 Dan Mueth and Chris Lyttle" msgstr "2000, 2005 Dan Mueth in Chris Lyttle" #. (itstool) path: bookinfo/copyright #: C/index.docbook:52 msgid "2007-2019 Stefan Sauer (Kost)" msgstr "2007-2019 Stefan Sauer (Kost)" #. (itstool) path: legalnotice/para #: C/index.docbook:65 #, fuzzy msgid "" "Permission is granted to copy, distribute and/or modify this document under " "the terms of the GNU Free Documentation License, " "Version 1.1 or any later version published by the Free Software Foundation " "with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A " "copy of the license is included." msgstr "" "Dovoljenje za kopiranje, distribucijo in/ali spreminjanje tega dokumenta je " "podeljeno pod pogoji licence GNU za prosto dokumentacijo, različica 1.1 ali katera koli novejša različica, ki jo je " "objavila Free Software Foundation brez nespremenljivih odsekov, besedil na " "sprednji strani in besedil na zadnji platnici. Priložena je kopija licence." #. (itstool) path: legalnotice/para #: C/index.docbook:73 #, fuzzy msgid "" "Many of the names used by companies to distinguish their products and " "services are claimed as trademarks. Where those names appear in any GNOME " "documentation, and those trademarks are made aware to the members of the " "GNOME Documentation Project, the names have been printed in caps or initial " "caps." msgstr "" "Mnoga imena, ki jih podjetja uporabljajo za razlikovanje svojih izdelkov in " "storitev, se uveljavljajo kot blagovne znamke. Če so ta imena navedena v " "kateri koli dokumentaciji GNOME in so te blagovne znamke sporočene članom " "dokumentacijskega projekta GNOME, so bila imena natisnjena z velikimi ali " "začetnimi kapicami." #. (itstool) path: revhistory/revision #: C/index.docbook:83 #, fuzzy msgid "" "1.33.0 1 Oct 2020 mc gtk4 version" msgstr "" "1.33.0 1. oktober 2020 " "mc gtk4 različica" #. (itstool) path: revhistory/revision #: C/index.docbook:89 #, fuzzy msgid "" "1.32.1 15 Aug 2019 ss dev version" msgstr "" "1.32.1 15. avgust 2019 " "Različica za razvijalce ss" #. (itstool) path: revhistory/revision #: C/index.docbook:95 #, fuzzy msgid "" "1.32 15 Aug 2019 ss hotfix release" msgstr "" "1.32 15. avgust 2019 Izdaja " "sprotnega popravka za ss" #. (itstool) path: revhistory/revision #: C/index.docbook:101 #, fuzzy msgid "" "1.31 05 Aug 2019 ss refactorings and more test coverage" msgstr "" "1.31 05 Avgust 2019 SS refaktoringi in več pokritosti testov" #. (itstool) path: revhistory/revision #: C/index.docbook:107 #, fuzzy msgid "" "1.30 08 May 2019 ss more test coverage" msgstr "" "1.30 08 maj 2019 ss več pokritosti testov" #. (itstool) path: revhistory/revision #: C/index.docbook:113 #, fuzzy msgid "" "1.29 28 Aug 2018 ss bug fixes" msgstr "" "1.29 28. avgust 2018 Popravki " "napak ss" #. (itstool) path: revhistory/revision #: C/index.docbook:119 #, fuzzy msgid "" "1.28 24 Mar 2018 ss bug fixes" msgstr "" "1.28 24 Mar 2018 Popravki " "napak ss" #. (itstool) path: revhistory/revision #: C/index.docbook:125 #, fuzzy msgid "" "1.27 07 Dec 2017 ss fine tuning of the python port" msgstr "" "1.27 07 Dec 2017 ss fino nastavitev vrat python" #. (itstool) path: revhistory/revision #: C/index.docbook:131 #, fuzzy msgid "" "1.26 11 Aug 2017 ss port all tools from perl/bash to python" msgstr "" "1.26 11. avgust 2017 SS," " vrata vsa orodja od Perl/Bash, do Pythona;" #. (itstool) path: revhistory/revision #: C/index.docbook:137 #, fuzzy msgid "" "1.25 21 March 2016 ss bug fixes, test cleanups" msgstr "" "1.25 21. marec 2016 Popravki napak SS, Testno čiščenje" #. (itstool) path: revhistory/revision #: C/index.docbook:143 #, fuzzy msgid "" "1.24 29 May 2015 ss bug fix" msgstr "" "1.24 29. maj 2015 " "Odpravljanje napak ss" #. (itstool) path: revhistory/revision #: C/index.docbook:149 #, fuzzy msgid "" "1.23 17 May 2015 ss bug fix" msgstr "" "1.23 17. maj 2015 " "Odpravljanje napak ss" #. (itstool) path: revhistory/revision #: C/index.docbook:155 #, fuzzy msgid "" "1.22 07 May 2015 ss bug fixes, dropping deprecated features" msgstr "" "1.22 07 maj 2015 Popravki napak SS, opustitev zastarelih funkcij" #. (itstool) path: revhistory/revision #: C/index.docbook:161 #, fuzzy msgid "" "1.21 17 Jul 2014 ss bug fixes, dropping deprecated features" msgstr "" "1.21 17. julij 2014 Popravki napak SS, opustitev zastarelih funkcij" #. (itstool) path: revhistory/revision #: C/index.docbook:167 #, fuzzy msgid "" "1.20 16 Feb 2014 ss bug fixes, markdown support, style improvements" msgstr "" "1.20 16 Feb 2014 Popravki napak SS, podpora za označevanje, " "izboljšave sloga" #. (itstool) path: revhistory/revision #: C/index.docbook:173 #, fuzzy msgid "" "1.19 05 Jun 2013 ss bug fixes" msgstr "" "1.19 05 Jun 2013 Popravki " "napak ss" #. (itstool) path: revhistory/revision #: C/index.docbook:179 #, fuzzy msgid "" "1.18 14 Sep 2011 ss bug fixes, speedups, markdown support" msgstr "" "1.18 14 Sep 2011 SS popravki napak, pospešitve, podpora za " "označevanje" #. (itstool) path: revhistory/revision #: C/index.docbook:185 #, fuzzy msgid "" "1.17 26 Feb 2011 sk urgent bug fix update" msgstr "" "1.17, 26. februar 2011 " "SK nujna posodobitev za " "odpravljanje napak" #. (itstool) path: revhistory/revision #: C/index.docbook:191 #, fuzzy msgid "" "1.16 14 Jan 2011 sk bugfixes, layout improvements" msgstr "" "1.16 14 Jan 2011 sk bugfixes, izboljšave postavitve" #. (itstool) path: revhistory/revision #: C/index.docbook:197 #, fuzzy msgid "" "1.15 21 May 2010 sk bug and regression fixes" msgstr "" "1.15 21. maj 2010 SK popravki napak in regresije" #. (itstool) path: revhistory/revision #: C/index.docbook:203 #, fuzzy msgid "" "1.14 28 March 2010 sk bugfixes and performance improvements" msgstr "" "1.14 28. marec 2010 Popravki " "napak in izboljšave učinkovitosti delovanja SK" #. (itstool) path: revhistory/revision #: C/index.docbook:209 #, fuzzy msgid "" "1.13 18 December 2009 " "sk broken tarball update" msgstr "" "1.13 18. december 2009 " "SK je prekinil posodobitev " "tarballa" #. (itstool) path: revhistory/revision #: C/index.docbook:215 #, fuzzy msgid "" "1.12 18 December 2009 " "sk new tool features and " "bugfixes" msgstr "" "1.12 18. december 2009 " "SK Nove funkcije orodij in " "popravki napak" #. (itstool) path: revhistory/revision #: C/index.docbook:221 #, fuzzy msgid "" "1.11 16 November 2008 " "mal GNOME doc-utils migration" msgstr "" "1.11 16. november 2008 " "mal GNOME doc-utils migracija" #. (itstool) path: chapter/title #: C/index.docbook:234 msgid "Introduction" msgstr "Uvod" #. (itstool) path: chapter/para #: C/index.docbook:236 #, fuzzy msgid "" "This chapter introduces GTK-Doc and gives an overview of what it is and how " "it is used." msgstr "" "To poglavje predstavlja GTK-Doc in podaja pregled, kaj je in kako se " "uporablja." #. (itstool) path: sect1/title #: C/index.docbook:242 msgid "What is GTK-Doc?" msgstr "Kaj je GTK-Doc?" #. (itstool) path: sect1/para #: C/index.docbook:244 #, fuzzy msgid "" "GTK-Doc is used to document C code. It is typically used to document the " "public API of libraries, such as the GTK+ and GNOME libraries. But it can " "also be used to document application code." msgstr "" "GTK-Doc se uporablja za dokumentiranje kode C. Običajno se uporablja za " "dokumentiranje javnega API-ja knjižnic, kot sta knjižnici GTK+ in GNOME. " "Lahko pa se uporablja tudi za dokumentiranje kode aplikacije." #. (itstool) path: sect1/title #: C/index.docbook:252 msgid "How Does GTK-Doc Work?" msgstr "Kako deluje GTK-Doc?" #. (itstool) path: sect1/para #: C/index.docbook:254 #, fuzzy msgid "" "GTK-Doc works by using documentation of functions placed inside the source " "files in specially-formatted comment blocks, or documentation added to the " "template files which GTK-Doc uses (though note that GTK-Doc will only " "document functions that are declared in header files; it won't produce " "output for static functions)." msgstr "" "GTK-Doc deluje tako, da uporablja dokumentacijo funkcij, nameščenih znotraj " "izvornih datotek v posebej oblikovanih blokih komentarjev, ali " "dokumentacijo, dodano datotekam predlog, ki jih uporablja GTK-Doc (čeprav " "upoštevajte, da bo GTK-Doc dokumentiral samo funkcije, ki so deklarirane v " "datotekah z glavo; ne bo ustvaril izhoda za statične funkcije)." #. (itstool) path: sect1/para #: C/index.docbook:261 #, fuzzy msgid "" "GTK-Doc consists of a number of python scripts, each performing a different " "step in the process." msgstr "" "GTK-Doc je sestavljen iz številnih skriptov python, od katerih vsak izvaja " "drugačen korak v procesu." #. (itstool) path: sect1/para #: C/index.docbook:266 msgid "There are 5 main steps in the process:" msgstr "Postopek obsega pet glavnih korakov:" #. (itstool) path: listitem/para #: C/index.docbook:273 #, fuzzy msgid "" "Writing the documentation. The author fills in the " "source files with the documentation for each function, macro, structs or " "unions, etc." msgstr "" "Pisanje dokumentacije. Avtor izpolni izvorne datoteke z " "dokumentacijo za vsako funkcijo, makro, strukture ali združitve itd." #. (itstool) path: listitem/para #: C/index.docbook:282 #, fuzzy msgid "" "Gathering information about the code. " "gtkdoc-scan scans the header files of the code " "looking for declarations of functions, macros, enums, structs, and unions. " "It creates the file <module>-decl-list.txt " "containing a list of the declarations, placing them into sections according " "to which header file they are in. On the first run this file is copied to " "<module>-sections.txt. The author can rearrange " "the sections, and the order of the declarations within them, to produce the " "final desired order. The second file it generates is <" "module>-decl.txt. This file contains the full declarations " "found by the scanner. If for some reason one would like some symbols to show " "up in the docs, where the full declaration cannot be found by the scanner or " "the declaration should appear differently, one can place entities similar to " "the ones in <module>-decl.txt into <" "module>-overrides.txt." msgstr "" "Zbiranje informacij o kodi. GTKDOC-scan skenira datoteke glave kode in išče deklaracije funkcij, " "makrov, enumov, struktur in združitev. Ustvari datoteko <" "modul>-decl-list.txt ki vsebuje seznam deklaracij, in jih " "razvrsti v razdelke, glede na to, v kateri glavni datoteki so. Ob prvem " "zagonu se ta datoteka kopira v <modul>-sections.txt. Avtor lahko preuredi odseke in vrstni red deklaracij v njih, da " "izdela končni želeni vrstni red. Druga datoteka, ki jo ustvari, je " "<modul>-decl.txt. Ta datoteka vsebuje popolne " "deklaracije, ki jih najde optični bralnik. Če bi iz nekega razloga želeli, " "da se v dokumentih prikažejo nekateri simboli, kjer skener ne more najti " "popolne deklaracije ali bi morala biti deklaracija videti drugače, lahko " "entitete, podobne tistim v <modulu>-decl.txt " "postavimo v <modul>-overrides.txt." #. (itstool) path: listitem/para #: C/index.docbook:299 #, fuzzy msgid "" "gtkdoc-scangobj can also be used to dynamically " "query a library about any GObject subclasses it exports. It saves " "information about each object's position in the class hierarchy and about " "any GObject properties and signals it provides." msgstr "" "Gtkdoc-scangobj lahko uporabite tudi za dinamično " "poizvedovanje po knjižnici o vseh podrazredih GObject, ki jih izvaža. " "Shranjuje informacije o položaju vsakega predmeta v hierarhiji razreda ter o " "vseh lastnostih in signalih GObject, ki jih zagotavlja." #. (itstool) path: listitem/para #: C/index.docbook:305 #, fuzzy msgid "" "gtkdoc-scanobj should not be used anymore. It was " "needed in the past when GObject was still GtkObject inside gtk+." msgstr "" "GTKDOC-scanobj se ne sme več uporabljati. " "Potreben je bil v preteklosti, ko je bil GObject še vedno GtkObject znotraj " "gtk +." #. (itstool) path: listitem/para #: C/index.docbook:312 #, fuzzy msgid "" "Generating the XML and HTML/PDF. gtkdoc-" "mkdb turns the template files into XML files in the xml/ subdirectory. If the source code " "contains documentation on functions, using the special comment blocks, it " "gets merged in here. If there are no tmpl files used it only reads docs from " "sources and introspection data." msgstr "" "Ustvarjanje XML in HTML/PDF. gtkdoc-mkdb pretvori datoteke predloge v datoteke XML v podimeniku " "xml/ . Če izvorna koda vsebuje " "dokumentacijo o funkcijah z uporabo posebnih blokov komentarjev, se tukaj " "združi. Če ni uporabljenih datotek tmpl, bere samo dokumente iz virov in " "podatke introspekcije." #. (itstool) path: listitem/para #: C/index.docbook:321 #, fuzzy msgid "" "gtkdoc-mkhtml turns the XML files into HTML files " "in the html/ subdirectory. Likewise " "gtkdoc-mkpdf turns the XML files into a PDF " "document called <package>.pdf." msgstr "" "gtkdoc-mkhtml pretvori datoteke XML v datoteke " "HTML v podimeniku html/ . Prav tako " "gtkdoc-mkpdf pretvori datoteke XML v dokument " "PDF, imenovan <paket>.pdf." #. (itstool) path: listitem/para #: C/index.docbook:327 #, fuzzy msgid "" "Files in xml/ and html/ directories are always overwritten. One " "should never edit them directly." msgstr "" "Datoteke v imenikih xml / in " "html/ so vedno prepisane. Nikoli " "jih ne bi smeli urejati neposredno." #. (itstool) path: listitem/para #: C/index.docbook:335 #, fuzzy msgid "" "Fixing up cross-references between documents. After " "installing the HTML files, gtkdoc-fixxref can be " "run to fix up any cross-references between separate documents. For example, " "the GTK+ documentation contains many cross-references to types documented in " "the GLib manual. When creating the source tarball for distribution, " "gtkdoc-rebase turns all external links into web-" "links. When installing distributed (pregenerated) docs the same application " "will try to turn links back to local links (where those docs are installed)." msgstr "" "Določanje navzkrižnih sklicev med dokumenti. Po " "namestitvi datotek HTML lahko zaženete gtkdoc-fixxref , da popravite morebitne navzkrižne sklice med ločenimi " "dokumenti. Dokumentacija GTK+ na primer vsebuje veliko sklicevanj na vrste, " "dokumentirane v priročniku GLib. Pri ustvarjanju izvorne tarball za " "distribucijo gtkdoc-rebase pretvori vse zunanje " "povezave v spletne povezave. Pri nameščanju porazdeljenih (vnaprej " "generiranih) dokumentov bo ista aplikacija poskušala obrniti povezave nazaj " "na lokalne povezave (kjer so ti dokumenti nameščeni)." #. (itstool) path: sect1/title #: C/index.docbook:353 msgid "Getting GTK-Doc" msgstr "Pridobivanje GTK-Doc" #. (itstool) path: sect2/title #: C/index.docbook:356 msgid "Requirements" msgstr "Zahteve" #. (itstool) path: sect2/para #: C/index.docbook:357 #, fuzzy msgid "" "python 2/3 - the main scripts are written in python." msgstr "" "Python 2/3 - glavne skripte so napisane v Pythonu." #. (itstool) path: sect2/para #: C/index.docbook:360 #, fuzzy msgid "" "xsltproc - the xslt processor from libxslt xmlsoft.org/XSLT/" msgstr "" "XSLTPROC - procesor XSLT podjetja Libxslt xmlsoft.org/XSLT/" #. (itstool) path: sect2/para #: C/index.docbook:364 #, fuzzy msgid "" "docbook-xsl - the docbook xsl stylesheets sourceforge.net/projects/docbook/files/docbook-xsl" msgstr "" "Docbook-XSL - Docbook XSL slogovne predloge sourceforge.net/projects/docbook/files/docbook-xsl" #. (itstool) path: sect2/para #: C/index.docbook:368 #, fuzzy msgid "" "One of source-highlight, highlight " "or vim - optional - used for syntax highlighting of " "examples" msgstr "" "Eden od označevalcev vira, poudarkov ali vim - izbirno - ki se uporablja za " "označevanje primerov v skladnji" #. (itstool) path: sect1/title #: C/index.docbook:376 msgid "About GTK-Doc" msgstr "O GTK-Doc" #. (itstool) path: sect1/para #: C/index.docbook:378 #, fuzzy msgid "" "Historically GTK-Doc was used to generate template files from the sources " "code. These template files could be used by developers to enter the API " "documentation. This approach was rather inconvenient because it required to " "keep the generated files under version control. Since GTK-Doc 1.9 it became " "possible to place all API information into source comments, which made the " "template support obsolete. In version 1.26 template support has been removed." msgstr "" "V preteklosti je bil GTK-Doc uporabljen za ustvarjanje datotek predlog iz " "izvorne kode. Razvijalci lahko te datoteke predlog uporabijo za vnos " "dokumentacije API-ja. Ta pristop je bil precej neprimeren, ker je zahteval, " "da ustvarjene datoteke ostanejo pod nadzorom različice. Od GTK-Doc 1.9 je " "bilo mogoče vse informacije o API-ju postaviti v izvorne komentarje, zaradi " "česar je podpora predloge zastarela. V različici 1.26 je bila podpora " "predloge odstranjena." #. (itstool) path: sect1/para #: C/index.docbook:388 C/index.docbook:402 msgid "(FIXME)" msgstr "(POPRAVIME)" #. (itstool) path: sect1/para #: C/index.docbook:392 msgid "" "(authors, web pages, mailing list, license, future plans, comparison with " "other similar systems.)" msgstr "" "(avtorji, spletne strani, poštni seznam, dovoljenje, prihodnji načrti, " "primerjava z drugimi podobnimi sistemi)" #. (itstool) path: sect1/title #: C/index.docbook:400 msgid "About this Manual" msgstr "O tem priročniku" #. (itstool) path: sect1/para #: C/index.docbook:406 msgid "(who it is meant for, where you can get it, license)" msgstr "(komu je namenjen, kje ga lahko dobite, dovoljenje)" #. (itstool) path: chapter/title #: C/index.docbook:415 #, fuzzy msgid "Project Setup" msgstr "Nastavitev projekta" #. (itstool) path: chapter/para #: C/index.docbook:417 #, fuzzy msgid "" "This Chapter describes the steps that are necessary to integrate GTK-Doc " "into your project. The integration of GTK-Doc into a project includes the " "following steps:" msgstr "" "V tem poglavju so opisani koraki, ki so potrebni za integracijo GTK-Doc v " "projekt. Integracija GTK-Doc v projekt vključuje naslednje korake:" #. (itstool) path: listitem/para #: C/index.docbook:425 #, fuzzy msgid "" "Preparation of the directory structure and creating required configuration " "files for your GTK-Doc documentation (see Setting up a skeleton documentation)." msgstr "" "Priprava strukture imenika in ustvarjanje zahtevanih konfiguracijskih " "datotek za dokumentacijo GTK-Doc (glejte Nastavitev skeletne dokumentacije)." #. (itstool) path: listitem/para #: C/index.docbook:433 #, fuzzy msgid "" "Adjusting the build system to build your documentation using the GTK-Doc " "tools. Multiple build systems are supported, in this manual we describe how " "to integrate GTK-Doc with Autotools, CMake, and plain Makefiles." msgstr "" "Prilagoditev sistema gradnje za izdelavo dokumentacije z orodji GTK-Doc. " "Podprtih je več gradbenih sistemov, v tem priročniku opisujemo, kako " "integrirati GTK-Doc z Autotools, CMake in navadnimi Makefiles." #. (itstool) path: listitem/para #: C/index.docbook:443 #, fuzzy msgid "" "Adding GTK-Doc specific files to version control and deciding which files to " "ignore (see Integration with version " "control systems)." msgstr "" "Dodajanje specifičnih datotek GTK-Doc za nadzor različic in odločanje o tem, " "katere datoteke prezreti (glejte " "Integracija s sistemi za nadzor različic)." #. (itstool) path: chapter/para #: C/index.docbook:451 #, fuzzy msgid "" "The following sections assume we work on a project called meep. " "This project contains two packages (or modules), a library called " "libmeep and an end-user app called meeper." msgstr "" "Naslednji razdelki predvidevajo, da delamo na projektu, imenovanem " "meep. Ta projekt vsebuje dva paketa (ali modula), knjižnico, " "imenovano libmeep in aplikacijo za končnega uporabnika, " "imenovano meeper." #. (itstool) path: sect1/title #: C/index.docbook:460 #, fuzzy msgid "Setting up a skeleton documentation" msgstr "Nastavitev skeletne dokumentacije" #. (itstool) path: sect1/para #: C/index.docbook:462 #, fuzzy msgid "" "A common convention is to place documentation into a folder called " "docs inside your top-level project directory. We usually " "distinguish between reference documentation intended " "for developers and an user manual intended for end-" "users. Again the convention is to have separate folders for both. We usually " "place the reference documentation in a folder named reference " "and the end-user manual in a folder named help as. According to " "the above convention the documentation for our libmeep package " "would be placed into: docs/reference/libmeep. For packages with " "just one library or application the documentation could also be placed " "directly into docs/reference. It is not mandatory to use the " "above convention, but if you choose to use a different directory structure " "you must adjust your build system configuration to match your directory " "structure." msgstr "" "Običajen dogovor je, da dokumentacijo vstavite v mapo, ki se imenuje " "docs v imeniku projektov najvišje ravni. Običajno razlikujemo " "med referenčno dokumentacijo , namenjeno razvijalcem, " "in uporabniškim priročnikom , namenjenim končnim " "uporabnikom. Ponovno, konvencija je, da imajo ločene mape za oba. Običajno " "postavimo referenčno dokumentacijo v mapo z imenom reference in " "priročnik za končnega uporabnika v mapo help , imenovano kot. V " "skladu z zgornjo konvencijo bo dokumentacija za naš libmeep " "paket vstavljena v: docs/reference/libmeep. Za pakete s samo " "eno knjižnico ali aplikacijo lahko dokumentacijo postavite tudi neposredno v " "docs/reference. Uporaba zgornjega dogovora ni obvezna, če pa se " "odločite za uporabo druge strukture imenika, morate prilagoditi " "konfiguracijo sistema gradnje, da se ujema s strukturo imenika." #. (itstool) path: example/title #: C/index.docbook:493 #, fuzzy msgid "Example directory structure of meep project" msgstr "Primer strukture imenika projekta EP" #. (itstool) path: example/programlisting #: C/index.docbook:495 #, fuzzy, no-wrap msgid "" "\n" "meep/\n" " docs/\n" " reference/ # reference documentation\n" " libmeep/\n" " meeper/\n" " help/ # optional: user manual\n" " meeper/\n" " src/\n" " libmeep/\n" " meeper/\n" msgstr "" "\n" "Poslanec Evropskega parlamenta/\n" " Docs/\n" " Sklic/ # referenčna dokumentacija\n" " libmeep/\n" " Meeper/\n" " pomoč/ # neobvezno: navodila za uporabo\n" " Meeper/\n" " ZRC/\n" " libmeep/\n" " Meeper/\n" #. (itstool) path: sect1/para #: C/index.docbook:487 #, fuzzy msgid "" "In the following sections we will assume a directory structure for our " "meep project that uses the above conventions. <_:" "example-1/>" msgstr "" "V naslednjih razdelkih bomo prevzeli imeniško strukturo za naš projekt " "EP , ki uporablja zgornje dogovore. <_:example-1/>" #. (itstool) path: sect1/title #: C/index.docbook:512 #, fuzzy msgid "Integration with Autotools" msgstr "Integracija z avtoorodji" #. (itstool) path: sect1/para #: C/index.docbook:513 #, fuzzy msgid "" "Integration of GTK-Doc into an autotools-based build system requires the " "following steps:" msgstr "" "Integracija GTK-Doc v sistem gradnje, ki temelji na avtoorodjih, zahteva " "naslednje korake:" #. (itstool) path: listitem/para #: C/index.docbook:519 #, fuzzy msgid "" "Ensure that gtkdocize is run once before the " "configure script. If an autogen.sh " "script is present, adjust it to check for GTK-Doc and add a call to " "gtkdocize." msgstr "" "Prepričajte se, da se gtkdocize zažene enkrat " "pred konfiguracijo skripta. Če je prisoten " "skript autogen.sh , ga prilagodite, da preverite, ali " "je na voljo GTK-Doc, in dodajte klic v gtkdocize." #. (itstool) path: listitem/para #: C/index.docbook:527 #, fuzzy msgid "" "The main purpose of gtkdocize is to make the " "gtk-doc.make Makefile and the gtk-doc.m4 macro definition file available to the build system, either by " "copying or linking it into the project." msgstr "" "Glavni namen gtkdocize je, da je gtk-" "doc.make Makefile in datoteka za makro definicijo gtk-" "doc.m4 na voljo sistemu gradnje, bodisi s kopiranjem ali " "povezovanjem v projekt." #. (itstool) path: listitem/para #: C/index.docbook:536 #, fuzzy msgid "" "Add the necessary autoconf macros to " "configure.ac to enable GTK-Doc in your build system to " "allow configuration of GTK-Doc via the generated configure script." msgstr "" "V configure.ac dodajte potrebne makre " "samodejnega zmanjševanja, da omogočite GTK-Doc v " "sistemu gradnje, da omogočite konfiguracijo GTK-Doc prek " "ustvarjenega konfiguracijskega skripta." #. (itstool) path: listitem/para #: C/index.docbook:542 #, fuzzy msgid "" "Among others with registers the --enable-gtk-doc option with " "the configure script." msgstr "" "Med drugim z registri možnost --enable-gtk-doc s " "konfiguriranjem skripta." #. (itstool) path: listitem/para #: C/index.docbook:548 #, fuzzy msgid "" "Create an automake script for each application or " "library in your project. In the example used in this documentation this step " "applies to both meeper and libmeep." msgstr "" "Ustvarite skript za samodejno izdelavo za vsako " "aplikacijo ali knjižnico v projektu. V primeru, uporabljenem v tej " "dokumentaciji, ta korak velja za oba meeper in libmeep." #. (itstool) path: sect1/para #: C/index.docbook:557 #, fuzzy msgid "" "In the following sections, we will perform the above steps in reverse order. " "We start with the automake scripts and work our " "way up to configure.ac and autogen.sh. Then we show how enable Gtk-Doc in the build system and how to " "build the documentation." msgstr "" "V naslednjih razdelkih bomo zgornje korake izvedli v obratnem vrstnem redu. " "Začnemo s skripti za samodejno izdelavo in se " "potrudimo do configure.ac in autogen.sh. Nato pokažemo, kako omogočiti Gtk-Doc v sistemu gradnje in kako " "zgraditi dokumentacijo." #. (itstool) path: sect2/title #: C/index.docbook:567 #, fuzzy msgid "Integration with automake" msgstr "Integracija s samodejno izdelavo" #. (itstool) path: sect2/para #: C/index.docbook:569 #, fuzzy msgid "" "First copy the Makefile.am from the examples sub-directory of the gtkdoc-" "sources to your project's reference documentation directory (e.g. " "docs/reference/<package>). A " "local copy should be available under e.g. /usr/share/doc/gtk-doc-" "tools/examples/Makefile.am. If you have multiple packages repeat " "this for each one." msgstr "" "Najprej kopirajte Makefile.am iz podimenika primerov virov gtkdoc v imenik referenčne dokumentacije projekta (npr. dokumenti/reference/<paket>). Lokalna kopija " "bi morala biti na voljo na primer pod /usr/share/doc/gtk-doc-tools/" "examples/makefile.am. Če imate več paketov, to ponovite za " "vsakega." #. (itstool) path: note/simpara #: C/index.docbook:582 #, fuzzy msgid "" "Do not forget to add each Makefile.am to the " "AC_CONFIG_FILES macro in configure.ac. For docs/reference/libmeep/Makefile.am you " "will need to add the entry docs/reference/libmeep/Makefile to AC_CONFIG_FILES." msgstr "" "Ne pozabite dodati vsakega Makefile.am v " "AC_CONFIG_FILES makro v configure.ac. Za dokumente / reference/libmeep/Makefile.am " "boste morali v AC_CONFIG_FILES dodati vnos " "docs/reference/libmeep/Makefile." #. (itstool) path: example/title #: C/index.docbook:594 #, fuzzy msgid "Example directory structure with Makefiles.am" msgstr "Primer strukture imenika s Makefiles.am" #. (itstool) path: example/programlisting #: C/index.docbook:597 #, fuzzy, no-wrap msgid "" "\n" "meep/\n" " docs/\n" " reference/ # reference documentation\n" " libmeep/\n" " Makefile.am\n" " meeper/\n" " Makefile.am\n" " help/ # optional: user manual\n" " meeper/\n" " src/\n" " libmeep/\n" " meeper/\n" msgstr "" "\n" "Poslanec Evropskega parlamenta/\n" " Docs/\n" " Sklic/ # referenčna dokumentacija\n" " libmeep/\n" " Makefile.am\n" " Meeper/\n" " Makefile.am\n" " pomoč/ # neobvezno: navodila za uporabo\n" " Meeper/\n" " ZRC/\n" " libmeep/\n" " Meeper/\n" #. (itstool) path: sect2/para #: C/index.docbook:613 #, fuzzy msgid "" "Next, you need to customize the copied Makefiles and provide values for the " "various parameters in each Makefile.am. All settings " "have a comment above them that describes their purpose and how to customize " "the setting. Most settings are used to supply extra flags to the respective " "tools to which they apply. Every tool has a variable of the form (e.g. the tool gtkdoc-mkhtml has an option named MKHTML_OPTIONS). All the tools " "support to list the supported options." msgstr "" "Nato morate prilagoditi kopirane datoteke Makefiles in navesti vrednosti za " "različne parametre v vsaki Makefile.am. Vse nastavitve " "imajo nad seboj komentar, ki opisuje njihov namen in kako prilagoditi " "nastavitev. Večina nastavitev se uporablja za zagotavljanje dodatnih " "zastavic ustreznim orodjem, na katera se nanašajo. Vsako orodje ima " "spremenljivko oblike is used to provide the name of the package that " "is being documentated (e.g. meeper, or libmeep)." msgstr "" " is used to specify the location of source " "directory which GTK-Doc searches for your API documentation. This will " "usually be DOC_SOURCE_DIR=$(top_srcdir)/src or a sub-" "directory of that directory." msgstr "" " and are used for " "dependencies. Each option take a file-glob (e.g. HFILE_GLOB=" "$(top_srcdir)/src/*.c). The documentation will be rebuilt if any of " "the matched files change." msgstr "" "