# Kazakh translation for gtk-doc. # Copyright (C) 2026 gtk-doc's COPYRIGHT HOLDER # This file is distributed under the same license as the gtk-doc package. # Baurzhan Muftakhidinov , 2026. # msgid "" msgstr "" "Project-Id-Version: gtk-doc master\n" "POT-Creation-Date: 2026-03-11 00:44+0000\n" "PO-Revision-Date: 2026-03-11 07:08+0500\n" "Last-Translator: Baurzhan Muftakhidinov \n" "Language-Team: Kazakh \n" "Language: kk\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "X-Generator: Poedit 3.8\n" #. Put one translator per line, in the form NAME , YEAR1, YEAR2 msgctxt "_" msgid "translator-credits" msgstr "Baurzhan Muftakhidinov " #. (itstool) path: bookinfo/title #: C/index.docbook:12 msgid "GTK-Doc Manual" msgstr "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 "" "Әзірлеушілерге арналған 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 "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 және 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 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 "" "Бұл құжатты Free Software Foundation жариялаған GNU Free " "Documentation License 1.1 нұсқасы немесе кез келген соңғы " "нұсқасының шарттарына сәйкес, Тұрақты бөлімдерсіз, Алдыңғы мұқаба мәтіндерсіз " "және Артқы мұқаба мәтіндерсіз көшіруге, таратуға және/немесе өзгертуге рұқсат " "етіледі. Лицензияның көшірмесі қоса берілген." #. (itstool) path: legalnotice/para #: C/index.docbook:73 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 "" "Компаниялар өздерінің өнімдері мен қызметтерін ерекшелеу үшін пайдаланатын " "көптеген атаулар сауда белгілері болып табылады. Мұндай атаулар кез келген " "GNOME құжаттамасында кездескенде және GNOME құжаттама жобасының мүшелеріне сол " "сауда белгілері туралы мәлім болса, бұл атаулар БАС ӘРІПТЕРМЕН немесе Бас " "әріппен басталып жазылған." #. (itstool) path: revhistory/revision #: C/index.docbook:83 msgid "" "1.33.0 1 Oct 2020 mc gtk4 version" msgstr "" "1.33.0 1 қазан 2020 mc gtk4 нұсқасы" #. (itstool) path: revhistory/revision #: C/index.docbook:89 msgid "" "1.32.1 15 Aug 2019 ss dev version" msgstr "" "1.32.1 15 тамыз 2019 ss әзірлеу нұсқасы" #. (itstool) path: revhistory/revision #: C/index.docbook:95 msgid "" "1.32 15 Aug 2019 ss hotfix release" msgstr "" "1.32 15 тамыз 2019 ss шұғыл түзету шығарылымы" #. (itstool) path: revhistory/revision #: C/index.docbook:101 msgid "" "1.31 05 Aug 2019 ss refactorings and more test coverage" msgstr "" "1.31 05 тамыз 2019 ss рефакторинг және көбірек тест қамтуы" #. (itstool) path: revhistory/revision #: C/index.docbook:107 msgid "" "1.30 08 May 2019 ss more test coverage" msgstr "" "1.30 08 мамыр 2019 ss көбірек тест қамтуы" #. (itstool) path: revhistory/revision #: C/index.docbook:113 msgid "" "1.29 28 Aug 2018 ss bug fixes" msgstr "" "1.29 28 тамыз 2018 ss қателерді түзету" #. (itstool) path: revhistory/revision #: C/index.docbook:119 msgid "" "1.28 24 Mar 2018 ss bug fixes" msgstr "" "1.28 24 наурыз 2018 ss қателерді түзету" #. (itstool) path: revhistory/revision #: C/index.docbook:125 msgid "" "1.27 07 Dec 2017 ss fine tuning of the python port" msgstr "" "1.27 07 желтоқсан 2017 ss python портын дәл баптау" #. (itstool) path: revhistory/revision #: C/index.docbook:131 msgid "" "1.26 11 Aug 2017 ss port all tools from perl/bash to python" msgstr "" "1.26 11 тамыз 2017 ss барлық саймандарды perl/bash-тан python-ға көшіру" #. (itstool) path: revhistory/revision #: C/index.docbook:137 msgid "" "1.25 21 March 2016 ss bug fixes, test cleanups" msgstr "" "1.25 21 наурыз 2016 ss қателерді түзету, тесттерді тазарту" #. (itstool) path: revhistory/revision #: C/index.docbook:143 msgid "" "1.24 29 May 2015 ss bug fix" msgstr "" "1.24 29 мамыр 2015 ss қатені түзету" #. (itstool) path: revhistory/revision #: C/index.docbook:149 msgid "" "1.23 17 May 2015 ss bug fix" msgstr "" "1.23 17 мамыр 2015 ss қатені түзету" #. (itstool) path: revhistory/revision #: C/index.docbook:155 msgid "" "1.22 07 May 2015 ss bug fixes, dropping deprecated features" msgstr "" "1.22 07 мамыр 2015 ss қателерді түзету, ескірген мүмкіндіктерді алып " "тастау" #. (itstool) path: revhistory/revision #: C/index.docbook:161 msgid "" "1.21 17 Jul 2014 ss bug fixes, dropping deprecated features" msgstr "" "1.21 17 шілде 2014 ss қателерді түзету, ескірген мүмкіндіктерді алып " "тастау" #. (itstool) path: revhistory/revision #: C/index.docbook:167 msgid "" "1.20 16 Feb 2014 ss bug fixes, markdown support, style improvements" msgstr "" "1.20 16 ақпан 2014 ss қателерді түзету, markdown қолдауы, стильді " "жақсарту" #. (itstool) path: revhistory/revision #: C/index.docbook:173 msgid "" "1.19 05 Jun 2013 ss bug fixes" msgstr "" "1.19 05 маусым 2013 ss қателерді түзету" #. (itstool) path: revhistory/revision #: C/index.docbook:179 msgid "" "1.18 14 Sep 2011 ss bug fixes, speedups, markdown support" msgstr "" "1.18 14 қыркүйек 2011 ss қателерді түзету, жылдамдату, markdown қолдауы" #. (itstool) path: revhistory/revision #: C/index.docbook:185 msgid "" "1.17 26 Feb 2011 sk urgent bug fix update" msgstr "" "1.17 26 ақпан 2011 sk шұғыл қателерді түзету жаңартуы" #. (itstool) path: revhistory/revision #: C/index.docbook:191 msgid "" "1.16 14 Jan 2011 sk bugfixes, layout improvements" msgstr "" "1.16 14 қаңтар 2011 sk қателерді түзету, жайманы жақсарту" #. (itstool) path: revhistory/revision #: C/index.docbook:197 msgid "" "1.15 21 May 2010 sk bug and regression fixes" msgstr "" "1.15 21 мамыр 2010 sk қателер мен регрессияларды түзету" #. (itstool) path: revhistory/revision #: C/index.docbook:203 msgid "" "1.14 28 March 2010 sk bugfixes and performance improvements" msgstr "" "1.14 28 наурыз 2010 sk қателерді түзету және өнімділікті жақсарту" #. (itstool) path: revhistory/revision #: C/index.docbook:209 msgid "" "1.13 18 December 2009 sk broken tarball update" msgstr "" "1.13 18 желтоқсан 2009 sk бүлінген tarball жаңартуы" #. (itstool) path: revhistory/revision #: C/index.docbook:215 msgid "" "1.12 18 December 2009 sk new tool features and bugfixes" msgstr "" "1.12 18 желтоқсан 2009 sk сайманның жаңа мүмкіндіктері мен қателерді түзету" #. (itstool) path: revhistory/revision #: C/index.docbook:221 msgid "" "1.11 16 November 2008 mal GNOME doc-utils migration" msgstr "" "1.11 16 қараша 2008 mal GNOME doc-utils миграциясы" #. (itstool) path: chapter/title #: C/index.docbook:234 msgid "Introduction" msgstr "Кіріспе" #. (itstool) path: chapter/para #: C/index.docbook:236 msgid "" "This chapter introduces GTK-Doc and gives an overview of what it is and how it " "is used." msgstr "" "Бұл тарау GTK-Doc-пен таныстырады және оның не екендігі мен қалай " "қолданылатыны туралы шолу береді." #. (itstool) path: sect1/title #: C/index.docbook:242 msgid "What is GTK-Doc?" msgstr "GTK-Doc дегеніміз не?" #. (itstool) path: sect1/para #: C/index.docbook:244 msgid "" "GTK-Doc is used to document C code. It is typically used to document the " "public API of libraries, such as GLib-based libraries, but it can also be used " "to document application code." msgstr "" "GTK-Doc C кодын құжаттау үшін пайдаланылады. Ол әдетте GLib негізіндегі " "кітапханалар сияқты кітапханалардың ашық API-ін құжаттау үшін қолданылады, " "бірақ оны қолданба кодын құжаттау үшін де пайдалануға болады." #. (itstool) path: sect1/title #: C/index.docbook:252 msgid "How Does GTK-Doc Work?" msgstr "GTK-Doc қалай жұмыс істейді?" #. (itstool) path: sect1/para #: C/index.docbook:254 msgid "" "GTK-Doc works by reading specially-formatted comment blocks placed inside the " "source files to document symbols such as functions, macros, structs, enums, " "etc. (though note that for most kind of symbols GTK-Doc will only document the " "symbols that are declared in header files; for example it won't produce output " "for static functions)." msgstr "" "GTK-Doc функциялар, макростар, құрылымдар, тізімдер және т.б. сияқты " "таңбаларды құжаттау үшін бастапқы файлдар ішіне орналастырылған арнайы " "пішімделген түсініктеме блоктарын оқу арқылы жұмыс істейді (бірақ таңбалардың " "көптеген түрлері үшін GTK-Doc тек тақырыптық файлдарда жарияланған таңбаларды " "ғана құжаттайтынын ескеріңіз; мысалы, ол статикалық функциялар үшін нәтиже " "бермейді)." #. (itstool) path: sect1/para #: C/index.docbook:262 msgid "" "GTK-Doc also reads template files where documentation can be added there as " "well." msgstr "" "GTK-Doc сонымен қатар құжаттаманы қосуға болатын үлгі файлдарын да оқиды." #. (itstool) path: sect1/para #: C/index.docbook:267 msgid "" "GTK-Doc consists of a number of programs, each performing a different step in " "the process." msgstr "" "GTK-Doc бірнеше бағдарламадан тұрады, олардың әрқайсысы процестің әртүрлі " "қадамын орындайды." #. (itstool) path: sect1/para #: C/index.docbook:272 msgid "The main steps are:" msgstr "Негізгі қадамдар:" #. (itstool) path: listitem/para #: C/index.docbook:279 msgid "" "Writing the documentation. The author fills in the source " "files with the documentation for each function, macro, structs or unions, etc." msgstr "" "Құжаттаманы жазу. Автор бастапқы файлдарды әрбір функция, " "макрос, құрылымдар немесе біріктірулер және т.б. үшін құжаттамамен толтырады." #. (itstool) path: listitem/para #: C/index.docbook:288 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 "" "Код туралы ақпаратты жинау. gtkdoc-scan кодтың тақырыптық файлдарын функциялар, макростар, тізімдер, " "құрылымдар және біріктірулердің декларацияларын іздеп сканерлейді. Ол " "декларациялар тізімі бар <module>-decl-list.txt " "файлын жасайды және оларды қай тақырыптық файлда болғанына байланысты " "бөлімдерге орналастырады. Бірінші іске қосуда бұл файл " "<module>-sections.txt файлына көшіріледі. Автор " "соңғы қалаған реттілікке қол жеткізу үшін бөлімдерді және олардың ішіндегі " "декларациялар ретін қайта реттей алады. Ол жасайтын екінші файл — " "<module>-decl.txt. Бұл файлда сканер тапқан толық " "декларациялар болады. Егер қандай да бір себеппен сканер толық декларацияны " "таба алмаса немесе декларация басқаша көрінуі тиіс болса және кейбір " "таңбалардың құжаттарда көрінуін қаласаңыз, <module>-decl.txt файлындағыға ұқсас нысандарды <module>-" "overrides.txt файлына орналастыруға болады." #. (itstool) path: listitem/para #: C/index.docbook:308 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 сонымен қатар кітапханадан ол " "экспорттайтын кез келген GObject ішкі кластары туралы динамикалық түрде сұрау " "үшін пайдаланылуы мүмкін. Ол әрбір объектінің класс иерархиясындағы орны және " "ол беретін кез келген GObject қасиеттері мен сигналдары туралы ақпаратты " "сақтайды." #. (itstool) path: listitem/para #: C/index.docbook:314 msgid "" "gtkdoc-scanobj should not be used anymore. It was " "needed in the past when GObject was still GtkObject inside GTK." msgstr "" "gtkdoc-scanobj бұдан былай пайдаланылмауы керек. Ол " "бұрын GObject әлі GTK ішінде GtkObject болған кезде қажет болған." #. (itstool) path: listitem/para #: C/index.docbook:322 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 for symbols, 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 "" "XML және HTML/PDF жасау. gtkdoc-mkdb үлгі файлдарын xml/ ішкі " "бумасындағы XML файлдарына айналдырады. Егер бастапқы кодта арнайы түсініктеме " "блоктарын пайдаланатын таңбаларға арналған құжаттама болса, ол осында " "біріктіріледі. Егер tmpl файлдары пайдаланылмаса, ол құжаттарды тек бастапқы " "кодтар мен интроспекция деректерінен оқиды." #. (itstool) path: listitem/para #: C/index.docbook:332 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 XML файлдарын html/ ішкі бумасындағы HTML файлдарына " "айналдырады. Сол сияқты gtkdoc-mkpdf XML файлдарын " "<package>.pdf деп аталатын PDF құжатына айналдырады." #. (itstool) path: listitem/para #: C/index.docbook:339 msgid "" "Files in xml/ and html/ directories are always overwritten. One " "should never edit them directly." msgstr "" "xml/ және html/ бумаларындағы файлдар әрқашан қайта " "жазылады. Оларды ешқашан тікелей түзетуге болмайды." #. (itstool) path: listitem/para #: C/index.docbook:347 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." msgstr "" "Құжаттар арасындағы өзара сілтемелерді түзету. HTML " "файлдарын орнатқаннан кейін, бөлек құжаттар арасындағы кез келген өзара " "сілтемелерді түзету үшін gtkdoc-fixxref " "бағдарламасын іске қосуға болады. Мысалы, GTK құжаттамасында GLib " "нұсқаулығында құжатталған типтерге көптеген өзара сілтемелер бар." #. (itstool) path: listitem/para #: C/index.docbook:356 msgid "" "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 "" "Таратуға арналған бастапқы архивті жасау кезінде gtkdoc-rebase барлық сыртқы сілтемелерді веб-сілтемелерге айналдырады. " "Таратылатын (алдын ала жасалған) құжаттарды орнатқан кезде дәл сол қолданба " "сілтемелерді жергілікті сілтемелерге (сол құжаттар орнатылған жерге) қайта " "айналдыруға тырысады." #. (itstool) path: sect1/title #: C/index.docbook:369 msgid "Getting GTK-Doc" msgstr "GTK-Doc алу" #. (itstool) path: sect2/title #: C/index.docbook:372 msgid "Requirements" msgstr "Талаптар" #. (itstool) path: sect2/para #: C/index.docbook:373 msgid "python 2/3 - the main scripts are written in python." msgstr "" "python 2/3 - негізгі скрипттер python тілінде жазылған." #. (itstool) path: sect2/para #: C/index.docbook:376 msgid "" "xsltproc - the xslt processor from libxslt xmlsoft.org/XSLT/" msgstr "" "xsltproc - libxslt-тен алынған xslt процессоры xmlsoft.org/XSLT/" #. (itstool) path: sect2/para #: C/index.docbook:380 msgid "" "docbook-xsl - the docbook xsl stylesheets sourceforge.net/projects/docbook/files/docbook-xsl" msgstr "" "docbook-xsl - docbook xsl стиль кестелері sourceforge.net/projects/docbook/files/docbook-xsl" #. (itstool) path: sect2/para #: C/index.docbook:384 msgid "" "One of source-highlight, highlight " "or vim - optional - used for syntax highlighting of " "examples" msgstr "" "source-highlight, highlight немесе " "vim біреуі - міндетті емес - мысалдардың синтаксисін " "жарықтандыру үшін қолданылады" #. (itstool) path: sect1/title #: C/index.docbook:392 msgid "About GTK-Doc" msgstr "GTK-Doc туралы" #. (itstool) path: sect1/para #: C/index.docbook:394 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 "" "Тарихи тұрғыдан GTK-Doc бастапқы кодтан үлгі файлдарын жасау үшін қолданылған. " "Бұл үлгі файлдарын әзірлеушілер API құжаттамасын енгізу үшін пайдалана алатын. " "Бұл тәсіл өте ыңғайсыз болды, өйткені ол жасалған файлдарды нұсқаларды бақылау " "жүйесінде сақтауды талап етті. GTK-Doc 1.9 нұсқасынан бастап барлық API " "ақпаратын бастапқы код түсіндірмелеріне орналастыру мүмкін болды, бұл " "үлгілерді қолдауды қажетсіз етті. 1.26 нұсқасында үлгілерді қолдау мүлдем " "алынып тасталды." #. (itstool) path: sect1/para #: C/index.docbook:404 C/index.docbook:418 msgid "(FIXME)" msgstr "(ТҮЗЕТУ КЕРЕК)" #. (itstool) path: sect1/para #: C/index.docbook:408 msgid "" "(authors, web pages, mailing list, license, future plans, comparison with " "other similar systems.)" msgstr "" "(авторлар, веб-беттер, тарату тізімі, лицензия, болашақ жоспарлар, басқа ұқсас " "жүйелермен салыстыру.)" #. (itstool) path: sect1/title #: C/index.docbook:416 msgid "About this Manual" msgstr "Бұл нұсқаулық туралы" #. (itstool) path: sect1/para #: C/index.docbook:422 msgid "(who it is meant for, where you can get it, license)" msgstr "(кімге арналған, қайдан алуға болады, лицензия)" #. (itstool) path: chapter/title #: C/index.docbook:431 msgid "Project Setup" msgstr "Жобаны баптау" #. (itstool) path: chapter/para #: C/index.docbook:433 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 "" "Бұл тарауда GTK-Doc-ты жобаңызға біріктіру үшін қажетті қадамдар сипатталған. " "GTK-Doc-ты жобаға біріктіру келесі қадамдарды қамтиды:" #. (itstool) path: listitem/para #: C/index.docbook:441 msgid "" "Preparation of the directory structure and creating required configuration " "files for your GTK-Doc documentation (see Setting up a skeleton documentation)." msgstr "" "Бума құрылымын дайындау және GTK-Doc құжаттамаңыз үшін қажетті конфигурация " "файлдарын жасау (Құжаттама қаңқасын " "баптау қараңыз)." #. (itstool) path: listitem/para #: C/index.docbook:449 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 "" "GTK-Doc саймандарын пайдаланып құжаттамаңызды құрастыру үшін құрастыру жүйесін " "реттеу. Бірнеше құрастыру жүйелеріне қолдау көрсетіледі, бұл нұсқаулықта біз " "GTK-Doc-ты Autotools, CMake және жай Makefiles жүйелерімен қалай " "біріктіруге болатынын сипаттаймыз." #. (itstool) path: listitem/para #: C/index.docbook:459 msgid "" "Adding GTK-Doc specific files to version control and deciding which files to " "ignore (see Integration with version control " "systems)." msgstr "" "GTK-Doc арнайы файлдарын нұсқаларды бақылау жүйесіне қосу және қай файлдарды " "елемеу керектігін шешу (Нұсқаларды бақылау " "жүйелерімен біріктіру қараңыз)." #. (itstool) path: chapter/para #: C/index.docbook:467 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 "" "Келесі бөлімдерде біз meep деп аталатын жобада жұмыс істейміз деп " "есептейміз. Бұл жоба екі дестеден (немесе модульден) тұрады: libmeep деп аталатын кітапхана және meeper деп аталатын соңғы " "пайдаланушы қолданбасы." #. (itstool) path: sect1/title #: C/index.docbook:476 msgid "Setting up a skeleton documentation" msgstr "Құжаттама қаңқасын баптау" #. (itstool) path: sect1/para #: C/index.docbook:478 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 "" "Жалпы қабылданған ереже — құжаттаманы жобаңыздың жоғарғы деңгейлі бумасындағы " "docs деп аталатын бумаға орналастыру. Біз әдетте әзірлеушілерге " "арналған анықтамалық құжаттама мен соңғы пайдаланушыларға " "арналған пайдаланушы нұсқаулығын ажыратамыз. Тағы да, " "екеуі үшін бөлек бумалардың болуы — қалыпты жағдай. Біз әдетте анықтамалық " "құжаттаманы reference деп аталатын бумаға, ал пайдаланушы " "нұсқаулығын help бумасына орналастырамыз. Жоғарыдағы ережеге " "сәйкес, біздің libmeep дестеміз үшін құжаттама мына жерде " "орналасады: docs/reference/libmeep. Тек бір кітапханасы немесе " "қолданбасы бар дестелер үшін құжаттама тікелей docs/reference " "ішіне де орналастырылуы мүмкін. Жоғарыдағы ережені қолдану міндетті емес, " "бірақ егер сіз басқа бума құрылымын таңдасаңыз, құрастыру жүйесінің " "конфигурациясын бума құрылымыңызға сәйкес реттеуіңіз керек." #. (itstool) path: example/title #: C/index.docbook:509 msgid "Example directory structure of meep project" msgstr "meep жобасының бума құрылымының мысалы" #. (itstool) path: example/programlisting #: C/index.docbook:511 #, 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" "meep/\n" " docs/\n" " reference/ # анықтамалық құжаттама\n" " libmeep/\n" " meeper/\n" " help/ # міндетті емес: пайдаланушы нұсқаулығы\n" " meeper/\n" " src/\n" " libmeep/\n" " meeper/\n" #. (itstool) path: sect1/para #: C/index.docbook:503 msgid "" "In the following sections we will assume a directory structure for our " "meep project that uses the above conventions. " "<_:example-1/>" msgstr "" "Келесі бөлімдерде біз жоғарыдағы ережелерді пайдаланатын meep жобасы үшін бума құрылымын қарастырамыз. <_:example-1/>" #. (itstool) path: sect1/title #: C/index.docbook:528 msgid "Integration with Autotools" msgstr "Autotools-пен біріктіру" #. (itstool) path: sect1/para #: C/index.docbook:529 msgid "" "Integration of GTK-Doc into an autotools-based build system requires the " "following steps:" msgstr "" "GTK-Doc-ты autotools-қа негізделген құрастыру жүйесіне біріктіру келесі " "қадамдарды талап етеді:" #. (itstool) path: listitem/para #: C/index.docbook:535 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 "" "gtkdocize бағдарламасы configure скриптінен бұрын бір рет іске қосылғанына көз жеткізіңіз. Егер " "autogen.sh скрипті болса, оны GTK-Doc-ты тексеру үшін " "реттеп, gtkdocize шақыруын қосыңыз." #. (itstool) path: listitem/para #: C/index.docbook:543 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 "" "gtkdocize бағдарламасының негізгі мақсаты — " "gtk-doc.make Makefile файлын және gtk-doc.m4 макрос анықтамасы файлын жобаға көшіру немесе сілтеу арқылы " "құрастыру жүйесіне қолжетімді ету." #. (itstool) path: listitem/para #: C/index.docbook:552 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 "" "Жасалған configure скрипті арқылы GTK-Doc конфигурациясын " "жасауға мүмкіндік беру үшін құрастыру жүйесінде GTK-Doc-ты іске қосатын " "configure.ac файлына қажетті autoconf макростарын қосыңыз." #. (itstool) path: listitem/para #: C/index.docbook:558 msgid "" "Among others with registers the --enable-gtk-doc option with the " "configure script." msgstr "" "Басқалармен қатар, бұл configure скриптімен --" "enable-gtk-doc опциясын тіркейді." #. (itstool) path: listitem/para #: C/index.docbook:564 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 "" "Жобаңыздағы әрбір қолданба немесе кітапхана үшін automake скриптін жасаңыз. Осы құжаттамада пайдаланылған мысалда бұл қадам " "meeper және libmeep екеуіне де қатысты." #. (itstool) path: sect1/para #: C/index.docbook:573 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 "" "Келесі бөлімдерде біз жоғарыдағы қадамдарды кері ретпен орындаймыз. Біз " "automake скрипттерінен бастап, " "configure.ac және autogen.sh " "файлдарына қарай жүреміз. Содан кейін құрастыру жүйесінде Gtk-Doc-ты қалай " "іске қосуды және құжаттаманы қалай құрастыруды көрсетеміз." #. (itstool) path: sect2/title #: C/index.docbook:583 msgid "Integration with automake" msgstr "Automake-пен біріктіру" #. (itstool) path: sect2/para #: C/index.docbook:585 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 "" "Алдымен examples ішкі бумасындағы " "Makefile.am файлын gtkdoc-sources ішінен " "жобаңыздың анықтамалық құжаттама бумасына (мысалы, docs/reference/<package>) көшіріңіз. " "Жергілікті көшірмесі мына жерде қолжетімді болуы керек: /usr/share/" "doc/gtk-doc-tools/examples/Makefile.am. Егер сізде бірнеше десте " "болса, мұны әрқайсысы үшін қайталаңыз." #. (itstool) path: note/simpara #: C/index.docbook:598 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 "" "Әрбір Makefile.am файлын configure.ac ішіндегі AC_CONFIG_FILES макросына қосуды " "ұмытпаңыз. docs/reference/libmeep/Makefile.am үшін " "AC_CONFIG_FILES ішіне docs/reference/libmeep/" "Makefile жазбасын қосу керек болады." #. (itstool) path: example/title #: C/index.docbook:610 msgid "Example directory structure with Makefiles.am" msgstr "Makefiles.am файлдары бар бума құрылымының мысалы" #. (itstool) path: example/programlisting #: C/index.docbook:613 #, 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" "meep/\n" " docs/\n" " reference/ # анықтамалық құжаттама\n" " libmeep/\n" " Makefile.am\n" " meeper/\n" " Makefile.am\n" " help/ # міндетті емес: пайдаланушы нұсқаулығы\n" " meeper/\n" " src/\n" " libmeep/\n" " meeper/\n" #. (itstool) path: sect2/para #: C/index.docbook:629 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 "" "Әрі қарай, көшірілген Makefile файлдарын теңшеуіңіз және әрбір " "Makefile.am ішіндегі түрлі параметрлерге мәндер беруіңіз " "керек. Барлық баптаулардың үстінде олардың мақсаты мен баптауды қалай теңшеу " "керектігін сипаттайтын түсіндірме бар. Көптеген баптаулар тиісті саймандарға " "қосымша жалаушалар беру үшін қолданылады. Әрбір сайманда қолдау көрсетілетін " "опцияларды тізімдеу үшін опциясы бар (мысалы, " "gtkdoc-mkhtml сайманында MKHTML_OPTIONS деп аталатын опция бар)." #. (itstool) path: listitem/para #: C/index.docbook:653 msgid "" " is used to provide the name of the package that is " "being documentated (e.g. meeper, or libmeep)." msgstr "" " құжатталатын дестенің атын көрсету үшін " "қолданылады (мысалы, meeper немесе libmeep)." #. (itstool) path: listitem/para #: C/index.docbook:660 msgid "" " 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 "" " GTK-Doc сіздің API құжаттамаңызды іздейтін " "бастапқы код бумасының орнын көрсету үшін қолданылады. Бұл әдетте " "DOC_SOURCE_DIR=$(top_srcdir)/src немесе сол буманың ішкі бумасы болады." #. (itstool) path: listitem/para #: C/index.docbook:673 msgid "" " 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 "" " және тәуелділіктер " "үшін қолданылады. Әрбір опция файл маскасын (file-glob) қабылдайды (мысалы, " "HFILE_GLOB=$(top_srcdir)/src/*.c). Сәйкес келетін файлдардың кез " "келгені өзгерсе, құжаттама қайта құрастырылады." #. (itstool) path: listitem/para #: C/index.docbook:685 msgid "" " allows to specify extra header files to include " "when scanning for API documentation, which are not found under " "DOC_SOURCE_DIR (e.g. EXTRA_HFILES=$(top_srcdir}/contrib/" "extra.h)." msgstr "" " API құжаттамасын сканерлеу кезінде " "DOC_SOURCE_DIR ішінде табылмаған қосымша тақырыптық файлдарды " "қосуға мүмкіндік береді (мысалы, EXTRA_HFILES=$(top_srcdir}/contrib/" "extra.h)." #. (itstool) path: listitem/para #: C/index.docbook:695 msgid "" " allows to specify header files or directories " "to ignore when scanning for API documentation. Use the basename of the file or " "directory (e.g. IGNORE_HFILES=gtkdebug.h gtkintl.h private_code_folder)." msgstr "" " API құжаттамасын сканерлеу кезінде елемейтін " "тақырыптық файлдарды немесе бумаларды көрсетуге мүмкіндік береді. Файлдың " "немесе буманың негізгі атын пайдаланыңыз (мысалы, " "IGNORE_HFILES=gtkdebug.h gtkintl.h private_code_folder)." #. (itstool) path: listitem/para #: C/index.docbook:705 msgid "" " allows to specify images files which will be " "copied into the html/ directory of the generated " "documentation. If your API documentation includes any images they need to be " "added to this option (e.g. HTML_IMAGES=$(top_srcdir)/gtk/stock-icons/" "stock_about_24.png)." msgstr "" " жасалған құжаттаманың html/ " "бумасына көшірілетін сурет файлдарын көрсетуге мүмкіндік береді. Егер сіздің " "API құжаттамаңызға қандай да бір суреттер кірсе, оларды осы опцияға қосу керек " "(мысалы, HTML_IMAGES=$(top_srcdir)/gtk/stock-icons/stock_about_24.png)." #. (itstool) path: listitem/para #: C/index.docbook:718 msgid "" " allows to specify extra files that are included " "by $(DOC_MAIN_SGML_FILE) (e.g. content_files=running.xml " "building.xml changes-2.0.xml)." msgstr "" " $(DOC_MAIN_SGML_FILE) файлына " "қосылатын қосымша файлдарды көрсетуге мүмкіндік береді (мысалы, " "content_files=running.xml building.xml changes-2.0.xml)." #. (itstool) path: listitem/para #: C/index.docbook:729 msgid "" " allows to specify files where " "gtk-doc abbreviations such as #GtkWidget are " "expanded (e.g. expand_content_files=running.xml)." msgstr "" " #GtkWidget сияқты " "gtk-doc қысқартулары жазылатын файлдарды көрсетуге " "мүмкіндік береді (мысалы, expand_content_files=running.xml)." #. (itstool) path: sect2/para #: C/index.docbook:647 msgid "" "The following list explains the most relevant options. Check the example " "Makefile.am for additional options. <_:itemizedlist-1/>" msgstr "" "Келесі тізімде ең маңызды опциялар түсіндірілген. Қосымша опциялар үшін " "Makefile.am мысалын қараңыз. <_:itemizedlist-1/>" #. (itstool) path: sect2/title #: C/index.docbook:744 msgid "Integration with autoconf" msgstr "Autoconf-пен біріктіру" #. (itstool) path: sect2/para #: C/index.docbook:746 msgid "" "Integration with autoconf is very simple and " "includes one required step and an additional optional (but recommended) step. " "The first step is to add the GTK_DOC_CHECK macro to your " "configure.ac script. This registers several configure " "options to enable GTK-Doc and allows you to set default arguments for " "gtkdocize." msgstr "" "autoconf жүйесімен біріктіру өте оңай және бір " "міндетті қадамды және қосымша міндетті емес (бірақ ұсынылатын) қадамды " "қамтиды. Бірінші қадам — configure.ac скриптіне " "GTK_DOC_CHECK макросын қосу. Бұл GTK-Doc-ты іске қосу " "үшін бірнеше конфигурация опцияларын тіркейді және gtkdocize үшін әдепкі аргументтерді орнатуға мүмкіндік береді." #. (itstool) path: warning/simpara #: C/index.docbook:758 msgid "" "Make sure that the GTK_DOC_CHECK macro is not indented. The macro " "must start at the beginning of the line and should not start with whitespace." msgstr "" "GTK_DOC_CHECK макросының шегініссіз екеніне көз жеткізіңіз. " "Макрос жолдың басынан басталуы керек және бос орыннан басталмауы керек." #. (itstool) path: sect2/para #: C/index.docbook:765 msgid "" "The second step is to add the AC_CONFIG_MACRO_DIR(m4) to your " "configure.ac. This is not required but helps " "gtkdocize to automatically copy the macro " "definition (e.g gtk-doc.m4) which contains the " "GTK_DOC_CHECK macro to your project's macro directory. " "Without this, the GTK_DOC_CHECK macro might not be found and you would need to " "explicitly tell the aclocal tool where to find the " "macro definition file." msgstr "" "Екінші қадам — configure.ac файлына " "AC_CONFIG_MACRO_DIR(m4) қосу. Бұл міндетті емес, бірақ " "gtkdocize бағдарламасына GTK_DOC_CHECK макросы бар макрос анықтамасын (мысалы, gtk-doc.m4) жобаңыздың макрос бумасына автоматты түрде көшіруге көмектеседі. " "Бұлсыз GTK_DOC_CHECK макросы табылмауы мүмкін және сізге aclocal сайманына макрос анықтамасы файлының қайда екенін нақты көрсету " "керек болады." #. (itstool) path: example/title #: C/index.docbook:778 msgid "Minimal integration with autoconf" msgstr "Autoconf-пен минималды біріктіру" #. (itstool) path: example/programlisting #: C/index.docbook:779 #, no-wrap msgid "" "\n" "# recommended: set m4 directory\n" "AC_CONFIG_MACRO_DIR(m4)\n" "# optional: register gtk-doc in configure\n" "GTK_DOC_CHECK([1.28])\n" msgstr "" "\n" "# ұсынылады: m4 бумасын орнату\n" "AC_CONFIG_MACRO_DIR(m4)\n" "# міндетті емес: configure-де gtk-doc тіркеу\n" "GTK_DOC_CHECK([1.28])\n" #. (itstool) path: example/title #: C/index.docbook:794 msgid "Integration with optional gtk-doc dependency" msgstr "Міндетті емес gtk-doc тәуелділігімен біріктіру" #. (itstool) path: example/programlisting #: C/index.docbook:795 #, no-wrap msgid "" "\n" "m4_ifdef([GTK_DOC_CHECK], [\n" "# recommended: set m4 directory\n" "AC_CONFIG_MACRO_DIR(m4)\n" "# optional: register gtk-doc in configure\n" "GTK_DOC_CHECK([1.28])\n" "],[\n" "AM_CONDITIONAL([ENABLE_GTK_DOC], false)\n" "])\n" msgstr "" "\n" "m4_ifdef([GTK_DOC_CHECK], [\n" "# ұсынылады: m4 бумасын орнату\n" "AC_CONFIG_MACRO_DIR(m4)\n" "# міндетті емес: configure-де gtk-doc тіркеу\n" "GTK_DOC_CHECK([1.28])\n" "],[\n" "AM_CONDITIONAL([ENABLE_GTK_DOC], false)\n" "])\n" #. (itstool) path: sect2/para #: C/index.docbook:788 msgid "" "The above example works, but will require all developers to have gtk-doc " "installed. A better way is to make building the documentation optional as " "shown in the next example: <_:example-1/>" msgstr "" "Жоғарыдағы мысал жұмыс істейді, бірақ ол барлық әзірлеушілерден gtk-doc " "орнатылған болуын талап етеді. Жақсырақ жол — келесі мысалда көрсетілгендей " "құжаттаманы құрастыруды міндетті емес ету: <_:example-1/>" #. (itstool) path: sect2/para #: C/index.docbook:808 msgid "" "The first argument is used to check for the Gtk-Doc version at configure time. " "The 2nd, optional argument is used by gtkdocize. " "The GTK_DOC_CHECK macro also adds several configure switches:" msgstr "" "Бірінші аргумент конфигурация кезінде Gtk-Doc нұсқасын тексеру үшін " "қолданылады. 2-ші, міндетті емес аргументті gtkdocize пайдаланады. GTK_DOC_CHECK макросы сонымен қатар " "бірнеше конфигурация ауыстырып-қосқыштарын қосады:" #. (itstool) path: listitem/para #: C/index.docbook:817 msgid "--with-html-dir=PATH : path to installed docs" msgstr "--with-html-dir=PATH : орнатылған құжаттардың жолы" #. (itstool) path: listitem/para #: C/index.docbook:818 msgid "--enable-gtk-doc : use gtk-doc to build documentation [default=no]" msgstr "" "--enable-gtk-doc : құжаттаманы құрастыру үшін gtk-doc пайдалану [әдепкі=жоқ]" #. (itstool) path: listitem/para #: C/index.docbook:819 msgid "--enable-gtk-doc-html : build documentation in html format [default=yes]" msgstr "--enable-gtk-doc-html : құжаттаманы html пішімінде құрастыру [әдепкі=иә]" #. (itstool) path: listitem/para #: C/index.docbook:820 msgid "--enable-gtk-doc-pdf : build documentation in pdf format [default=no]" msgstr "--enable-gtk-doc-pdf : құжаттаманы pdf пішімінде құрастыру [әдепкі=жоқ]" #. (itstool) path: important/para #: C/index.docbook:824 msgid "" "GTK-Doc is disabled by default! Remember to pass the option to the next configure run. Otherwise " "pregenerated documentation is installed (which makes sense for users but not " "for developers)." msgstr "" "GTK-Doc әдепкі бойынша сөндірулі! Келесі configure іске " "қосу кезінде опциясын беруді ұмытпаңыз. " "Әйтпесе, алдын ала жасалған құжаттама орнатылады (бұл пайдаланушылар үшін " "тиімді, бірақ әзірлеушілер үшін емес)." #. (itstool) path: sect2/para #: C/index.docbook:832 msgid "" "After all changes to configure.ac are made, update the " "configure file. This can be done by re-running " "autogen.sh." msgstr "" "configure.ac файлына барлық өзгерістер енгізілгеннен " "кейін, configure файлын жаңартыңыз. Мұны " "autogen.sh файлын қайта іске қосу арқылы жасауға болады." #. (itstool) path: sect2/title #: C/index.docbook:840 msgid "Integration with autogen" msgstr "Autogen-мен біріктіру" #. (itstool) path: sect2/para #: C/index.docbook:842 msgid "" "Most projects will have an autogen.sh script to setup the " "build infrastructure after the project was checked out from a version control " "system (such as git or svn). GTK-Doc comes with a script called " "gtkdocize which can be used to copy the necessary " "files needed by Gtk-Doc to the source directory." msgstr "" "Көптеген жобаларда жоба нұсқаларды бақылау жүйесінен (мысалы, git немесе svn) " "алынғаннан кейін құрастыру инфрақұрылымын баптау үшін autogen.sh скрипті болады. GTK-Doc құрамында Gtk-Doc үшін қажетті файлдарды " "бастапқы код бумасына көшіру үшін қолданылатын gtkdocize атты скрипт бар." #. (itstool) path: sect2/para #: C/index.docbook:850 msgid "It should be run before autoreconf, autoheader, automake or autoconf." msgstr "" "Оны autoreconf, autoheader, automake немесе autoconf-тан бұрын іске қосу керек." #. (itstool) path: example/title #: C/index.docbook:855 msgid "Running gtkdocize from autogen.sh" msgstr "gtkdocize бағдарламасын autogen.sh ішінен іске қосу" #. (itstool) path: example/programlisting #: C/index.docbook:856 #, no-wrap msgid "" "\n" "gtkdocize || exit 1\n" msgstr "" "\n" "gtkdocize || exit 1\n" #. (itstool) path: example/title #: C/index.docbook:864 msgid "Conditionally run gtkdocize from autogen.sh" msgstr "gtkdocize бағдарламасын autogen.sh ішінен шартты түрде іске қосу" #. (itstool) path: example/programlisting #: C/index.docbook:865 #, no-wrap msgid "" "\n" "GTKDOCIZE=$(which gtkdocize 2>/dev/null)\n" "if test $? -ne 0; then\n" " echo \"No gtk-doc support found. You can't build the docs.\"\n" "else\n" " $GTKDOCIZE || exit 1\n" "fi\n" msgstr "" "\n" "GTKDOCIZE=$(which gtkdocize 2>/dev/null)\n" "if test $? -ne 0; then\n" " echo \"gtk-doc қолдауы табылмады. Құжаттарды құрастыра алмайсыз.\"\n" "else\n" " $GTKDOCIZE || exit 1\n" "fi\n" #. (itstool) path: sect2/para #: C/index.docbook:876 msgid "" "When running gtkdocize it copies gtk-" "doc.make to your project root (or any directory specified by the " " option)." msgstr "" "gtkdocize іске қосылғанда, ол gtk-" "doc.make файлын жобаңыздың түбіріне (немесе