devhelp master - en to tr translation catalogue (47 entries)

note: (itstool) path: page/title (itstool) path: section/title
en: Book format
tr: Kitap biçimi

note: (itstool) path: synopsis/p
en: A “book” in <app>Devhelp</app> is the API documentation for one module, or package (usually a library). This page describes the format that a book needs to follow in order for <app>Devhelp</app> to recognize it.
tr: <app>Devhelp</app>'teki “kitap”, bir modül veya paket (genellikle kütüphane) için API belgeleridir. Bu sayfada, <app>Devhelp</app>ʼin tanıması için bir kitabın izlemesi gereken biçim açıklanmaktadır.

note: (itstool) path: page/p
en: The content of a book is placed in one directory (that directory contains only one book, it cannot contain several books). The directory is comprised of:
tr: Kitabın içeriği bir dizine yerleştirilir (bu dizin yalnızca tek bir kitap içerir, birden çok kitap içeremez). Dizin aşağıdakileri içerebilir:

note: (itstool) path: item/p
en: HTML pages, plus possibly CSS files, images, etc;
tr: HTML sayfaları, olası CSS dosyaları, görüntüler, vs.;

note: (itstool) path: item/p
en: An index file with the <file>*.devhelp2</file> file extension, see <link xref="index-file-format"/> for more information.
tr: <file>*.devhelp2</file> dosya uzantılı indeks, daha çok bilgi için bakınız: <link xref="index-file-format"/>.

note: (itstool) path: note/p
en: Restriction: the name of the directory the <file>*.devhelp2</file> file is in and the name of the <file>*.devhelp2</file> file (minus the extension) must match. In other words, if the book directory is called <code>$book_name</code>, then the absolute path to the index file should end with <code>$book_name/$book_name.devhelp2</code>. That way, when <app>Devhelp</app> knows the directory name, it directly knows the location to the index file.
tr: Kısıtlama: <file>*.devhelp2</file> dosyasının bulunduğu dizinin adı ve <file>*.devhelp2</file> dosyasının (uzantı hariç) adı aynı olmalıdır. Diğer deyişle, kitap dizini <code>$kitap_adi</code> olarak adlandırılırsa, indeks dosyasının mutlak yolu ve dosya uzantısı <code>$kitap_adi/$kitap_adi.devhelp2</code> olmalıdır. Böylece, <app>Devhelp</app> dizin adını bildiğinde, indeksin konumunu da doğrudan bilir.

note: (itstool) path: page/title
en: Index file format
tr: İndeks dosya biçimi

note: (itstool) path: synopsis/p
en: This page describes the purpose and the format of <file>*.devhelp2</file> index files.
tr: Bu sayfada, <file>*.devhelp2</file> indeks dosyalarının amacı ve biçimi açıklanmaktadır.

note: (itstool) path: page/p
en: A book (see <link xref="book-format"/>) contains one index file. The index file has the extension <file>.devhelp2</file> and has an XML format.
tr: Her kitap (bkz. <link xref="book-format"/>) indeks dosyası içerir. İndeks dosyası <file> .devhelp2 </file> uzantılıdır ve XML biçimindedir.

note: (itstool) path: note/p
en: The “2” in the <file>*.devhelp2</file> file extension is because it is the second version of the file format. The first version of the format, with the <file>*.devhelp</file> file extension, is deprecated and its support in <app>Devhelp</app> may be removed in the future. On application startup, when <app>Devhelp</app> scans the filesystem to find books, it emits a warning message in the terminal for each book that uses a deprecated format.
tr: <file>*.devhelp2</file> dosya uzantısındaki “2”, dosya biçiminin ikinci sürümü olduğunu belirtir. Biçimin <file>* .devhelp</file> dosya uzantılı ilk sürümü kullanımdan kaldırılmıştır ve <app>Devhelp</app> içindeki desteği gelecekte kaldırılabilir. Uygulama başlatıldığında, <app>Devhelp</app> kitapları bulmak için dosya sistemini tarar ve kullanımdan kaldırılmış biçim kullanan her kitap için uçbirimde uyarı iletisi yayımlar.

note: (itstool) path: page/p
en: The index file mainly contains:
tr: İndeks dosyası temel olarak şunları içerir:

note: (itstool) path: item/p
en: The book structure (like a table of contents).
tr: Kitap yapısı (içindekiler tablosu gibi).

note: (itstool) path: item/p
en: A list of symbols (functions, types, macros, signals, properties, …).
tr: Simge listesi (fonksiyonlar, türler, makrolar, sinyaller, özellikler, …).

note: (itstool) path: page/p
en: These contain links to the HTML files to reach the corresponding pages and symbols.
tr: Bunlar, karşılık gelen sayfalara ve simgelere ulaşmak için HTML dosyalarına bağlantılar içerir.

note: (itstool) path: page/p
en: In <app>Devhelp</app> the book structure is shown in the side panel. And the <link xref="search">search in the side panel</link> shows results found in the index files.
tr: <app>Devhelp</app>ʼte kitap yapısı yan bölmede gösterilir. Ve <link xref="search">yan bölmede ara</link>, indeks dosyalarında bulunan sonuçları gösterir.

note: (itstool) path: section/title
en: Specification of the <file>*.devhelp2</file> XML file format
tr: <file>*.devhelp2</file> XML dosya biçiminin özellikleri

note: (itstool) path: section/p
en: Unfortunately the <file>*.devhelp2</file> XML file format is not well documented. There is still some hope that it will be fixed in the near future. In the meantime, we recommend to look at what <link xref="installing-api-documentation#gtk-doc">GTK-Doc</link> generates. For the most precise definition of what <app>Devhelp</app> supports, read the parser source code and the <app>Devhelp</app> API reference.
tr: <file>*.devhelp2</file> XML dosya biçimi tümüyle belgelendirilmemiştir. Yakın gelecekte düzeltilmesi yönünde umut var. Bu açığı kapatmak için, <link xref="installing-api-documentation#gtk-doc">GTK-Doc</link>ʼun ne ürettiğine bakmanızı öneririz. <app>Devhelp</app>ʼin daha  neyi desteklediğinin en kesin tanımı için ayrıştırıcı kaynak kodunu ve <app>Devhelp</app> API referansını okuyun.

[ctx: link:trail]
note: (itstool) path: info/title
en: Devhelp User Documentation
tr: Devhelp Kullanıcı Belgelendirmesi

[ctx: text]
note: (itstool) path: info/title
en: Devhelp User Documentation
tr: Devhelp Kullanıcı Belgelendirmesi

[ctx: link]
note: (itstool) path: info/title
en: Devhelp User Documentation
tr: Devhelp Kullanıcı Belgelendirmesi

note: (itstool) path: info/desc
en: Devhelp User Documentation
tr: Devhelp Kullanıcı Belgelendirmesi

note: (itstool) path: page/title
en: <_:media-1/> Devhelp User Documentation
tr: Devhelp Kullanıcı Belgelendirmesi

note: (itstool) path: synopsis/p
en: Devhelp is a developer tool for browsing and searching API documentation.
tr: Devhelp, API belgelendirmesini tarama ve aramada kullanılan geliştirici aracıdır.

note: (itstool) path: page/title
en: Installing API documentation
tr: API belgelendirmesinin kurulması

note: (itstool) path: synopsis/p
en: How <app>Devhelp</app> finds the API documentation.
tr: <app>Devhelp</app>, API belgelendirmelerini nasıl bulur?

note: (itstool) path: section/p
en: See <link xref="book-format"/> for information on the API documentation format that <app>Devhelp</app> recognizes.
tr: <app>Devhelp</app>ʼin tanıdığı API belgelendirme biçimleriyle ilgili bilgi almak için bakınız: <link xref="book-format"/>.

note: (itstool) path: section/title
en: Books locations
tr: Kitapların konumları

note: (itstool) path: section/p
en: Once a book follows the right format, its directory needs to be installed at a location where <app>Devhelp</app> will find it.
tr: Kitap doğru biçimi izlediğinde, dizininin de <app>Devhelp</app>ʼin bulacağı konuma kurulması gerekir.

note: (itstool) path: section/p
en: <app>Devhelp</app> uses the <link href="https://specifications.freedesktop.org/basedir-spec/latest/">XDG Base Directory Specification</link> to find the books. The list of locations searched is:
tr: <app>Devhelp</app> kitapları bulmak için <link href="https://specifications.freedesktop.org/basedir-spec/latest/">XDG Temel Dizin Tanımlaması</link>'nı kullanır. Aranan konumların listesi:

note: (itstool) path: section/p
en: Note that the two latter consist of lists of directories to look for. Directory values are separated by <code>:</code> characters. Those environment variables are normally set up by the desktop environment or distribution.
tr: Son ikisinin aranacak dizinlerin listelerinden oluştuğunu unutmayın. Dizin değerleri <code>:</code> karakterleriyle ayrılmıştır. Bu ortam değişkenleri genellikle masaüstü ortamı veya dağıtımca ayarlanır.

note: (itstool) path: section/p
en: Examples of locations to index files with <code>$XDG_DATA_HOME</code> on a typical system:
tr: Tipik bir sistemde <code>$XDG_DATA_HOME</code> ile birlikte indeks dosyalarının konum örnekleri:

note: (itstool) path: item/p
en: <file>~/.var/app/org.gnome.Devhelp/data/devhelp/books/glib/glib.devhelp2</file> if <app>Devhelp</app> is launched with <link href="https://flatpak.org/">Flatpak</link>.
tr: Eğer <app>Devhelp</app> <link href="https://flatpak.org/">Flatpak</link> ile başlatılmışsa <file>~/.var/app/org.gnome.Devhelp/data/devhelp/books/glib/glib.devhelp2</file>.

note: (itstool) path: section/p
en: Example of a location to an index file with <code>$XDG_DATA_DIRS</code> on a typical system:
tr: Tipik bir sistemde <code>$XDG_DATA_DIRS</code> ile birlikte indeks dosyasının konum örneği:

note: (itstool) path: section/p
en: <link href="https://gitlab.gnome.org/GNOME/gtk-doc">GTK-Doc</link> is a tool to generate API documentation from comments added to C code. It is used by GLib, GTK and GNOME libraries and applications.
tr: <link href="https://gitlab.gnome.org/GNOME/gtk-doc">GTK-Doc</link>, C koduna eklenen yorumlardan API belgeleri oluşturmak için araçtır. GLib, GTK ve GNOME kütüphaneleri ve uygulamalarınca kullanılır.

note: (itstool) path: section/p
en: GTK-Doc installs the API reference of a module into:
tr: GTK-Doc, modülün API referansını şuraya kurar:

note: (itstool) path: section/p
en: It follows the book format supported by <app>Devhelp</app>. So by using GTK-Doc, the API reference can be browsed in <app>Devhelp</app> automatically (once installed in the right location, that is).
tr: <app>Devhelp</app>ʼin desteklediği kitap biçimine uyar. GTK-Doc kullanılarak, (doğru konuma kurulduktan sonra) API referansı <app>Devhelp</app> ile kendiliğinden taranabilir.

note: (itstool) path: page/title
en: Search in the side panel
tr: Yan bölmede ara

note: (itstool) path: synopsis/p
en: How the search in the side panel works.
tr: Yan bölmede arama nasıl çalışır?

note: (itstool) path: section/title
en: Case sensitivity
tr: Büyük/küçük harf duyarlı

note: (itstool) path: section/p
en: The search is case sensitive when there is an uppercase letter. If the search terms are all in lowercase, the search is case insensitive. It's like the “smartcase” feature present in some text editors.
tr: Büyük harf içeriyorsa, arama büyük/küçük harf duyarlıdır. Arama terimlerinin tümü küçük harflerle yazılmışsa, arama büyük/küçük harf duyarlı değildir. Bazı metin düzenleyicilerdeki “smartcase” (akıllı büyük/küçük) özelliği gibi çalışır.

note: (itstool) path: section/title
en: Glob-style pattern matching
tr: Küremsi desen eşleştirmesi

note: (itstool) path: section/p
en: A search term can be a pattern containing ‘*’ and ‘?’ wildcards. ‘*’ matches an arbitrary, possibly empty, string; and ‘?’ matches an arbitrary character.
tr: Arama terimi ‘*’ ve ‘?’ joker karakterlerini içeren desen olabilir. ‘*’ seçimlik ve boş olabilen dizgeyle eşleşir; ‘?’ seçimlik bir karakterle eşleşir.

note: (itstool) path: section/title
en: Several search terms
tr: Türlü arama terimleri

note: (itstool) path: section/p
en: You can search with several search terms (separated by spaces). A symbol will match only if <em>all</em> the search terms individually match (not necessarily in the same order of appearance).
tr: Türlü arama terimleriyle (boşlukla ayırarak) arama yapabilirsiniz. Bir simge yalnızca <em>tüm</em> arama terimleriyle tek tek eşleşmesi durumunda eşleşir (aynı görünüm sırasında olması gerekmez).

note: (itstool) path: section/p
en: Note that it is different than searching with the ‘*’ wildcard: with the ‘*’ wildcard it forces the keywords to be in the same order.
tr: Bunun, ‘*’ joker karakteriyle arama yapmaktan farklı olduğunu unutmayın: ‘*’ joker karakteri, anahtar sözcükleri aynı sırada olmaya zorlar.

note: (itstool) path: section/p
en: For example when searching “<input>gtk window application</input>”, it matches both “<code>gtk_window_get_application()</code>” and “<code>GtkApplicationWindow</code>” (among other symbols).
tr: Örneğin, “<input>gtk window application</input>” araması, hem “<code>gtk_window_get_application()</code>”, hem de (diğer simgelerle birlikte) “<code>GtkApplicationWindow</code>” ile eşleşir.

note: (itstool) path: section/p
en: On the other hand, searching “<input>gtk*window*application</input>” will match “<code>gtk_window_get_application()</code>” but not “<code>GtkApplicationWindow</code>”.
tr: Diğer yandan, “<input>gtk*window*application</input>” araması “<code>gtk_window_get_application()</code>” ile eşleşir ancak “<code>GtkApplicationWindow</code>” ile eşleşmez.
