# Atıflar ve kaynakça

Bir kaynak bulun, üst verilerini inceleyin, doğru kaynakçaya ekleyin, imleçte atıf verin, bir Typst atıf stili seçin ve özgün kaynağı kaybetmeden bir kitaplığı temizleyin.

Atıf bir zincirdir: iddia bir anahtara, anahtar bir kaynakça kaydına, kayıt da gerçek bir kaynağa işaret eder. Oleafly bu zinciri görünür tutar; böylece hızlı bir arama sonradan gizemli bir başvuruya dönüşmez.

![Oleafly'nin Kaynaklar paneli. Kaynaklar, Atıflar ve Simgeler arasında geçiş yapın; geçerli görünümü arama alanından filtreleyin.](https://cdn.oleafly.com/images/screenshots/desktop/docs/references-panel-dark-window-v2.png#view=0,45,344,703)

## Yazarken atıf verin

![Projeden atıf ver, kaynakça seçicisini açar. Anahtar, yazar ya da başlığa göre arayın; Yeni bir atıf bul ve ekle çevrim içi aramayı açar.](https://cdn.oleafly.com/images/screenshots/desktop/docs/llama-citation-picker-dark-window-v2.png#view=415,77,365,467)

LaTeX ya da Typst araç çubuğunda **Projeden atıf ver**'i (`@` simgesi) seçin. Geçerli kaynakçayı anahtar, yazar ya da başlığa göre arayın ve bir kayıt seçin.

**Atıf ekle**'yi ⌘K ya da Ctrl+K komut paletinden de çalıştırabilirsiniz. Oleafly, etkin proje için sözdizimini ekler:

- LaTeX'te `\cite{key}`;
- Typst'te `@key`; ana belgede `#bibliography(...)` satırı yoksa belgenin sonuna bu satırı ekler;
- Markdown'da `[@key]`; gerektiğinde ön bilgilere `bibliography:` satırı ekler.

Zotero bağlıyken **Atıf ekle**, eşleşmeleri önce Zotero kitaplığınızdan listeler.

## Zotero kitaplığınızdan atıf verin

[Zotero bağlandıktan](/docs/integrations/research-sources/#zotero) sonra `@` yazın ve bir yazar adının parçasını, başlıktan bir sözcüğü, bir yılı ya da bir anahtarı yazın. Zotero kitaplığınızın tamamı, projenin kendi kaynaklarının yanında görünür. Bir makale seçin; Oleafly atfı, belgenin hâlihazırda atıf verdiği biçimde ekler. LaTeX, belgenin en çok kullandığı komutu alır (`\citep` ya da `\parencite` gibi); Typst `@key`, Markdown `[@key]` alır. Var olan bir `\cite{...}` içine `@` yazmak ona başka bir anahtar ekler.

Yalnızca o tek kayıt, projenin `.bib` dosyasına ve dosyanın sonuna gider; dosyanın geri kalanı olduğu gibi kalır. `.bib` içinde anahtarıyla ya da DOI'siyle hâlihazırda bulunan bir makale asla iki kez eklenmez. Kayıtlar hiçbir zaman bilgisayarınızdaki PDF'lerin yollarını içermez. Projede henüz kaynakça satırı yoksa Oleafly bir tane ekler: LaTeX'te `\bibliography` ya da `\addbibresource`, Typst'te `#bibliography`, Markdown'da ön bilgilere `bibliography:`. Birden fazla `.bib` dosyası varsa Oleafly, hangi dosyanın yeni kaynakları alacağını bir kez sorar ve yanıtınızı anımsar.

Kaynaklarını elle listeleyen, yani `thebibliography` ortamı kullanan bir LaTeX makalesinde Zotero'dan ilk kez atıf verdiğinizde Oleafly bu listeyi `.bib` dosyasına taşımayı önerir. Böylece her kaynak tek bir numaralı listeyi paylaşır.

### .bib dosyasını Zotero ile uyumlu tutun

`.bib` dosyasında olmayan ama Zotero'da bulunan atıflı bir anahtar, **Zotero'dan ekle** seçeneğini sunar. Atıflı tüm anahtarları bir kerede denetlemek için ⌘K paletinden **Eksik atıfları Zotero'dan ekle**'yi çalıştırın. Zotero'da olanları ekler, olmayanları listeler ve kaynakçanızda hâlihazırda bulunan bir makaleye atıf veren anahtarları işaret eder.

Zotero'da bir makale değiştiğinde, `.bib` kaydı **Zotero'dan güncelle** seçeneğini sunar. Paletteki **.bib kayıtlarını Zotero'dan güncelle**, değişen her kaydı gözden geçirir. Elle düzenlediğiniz bir kayıt yalnızca onayladıktan sonra değiştirilir. **Zotero kitaplığını eşitle** kitaplığı yeniden okur. Oleafly, `.bib` dosyasından kendi başına hiçbir şey kaldırmaz.

![Bir makalenin başlığından bir parça yapıştırılır ve BibTeX girdisi refs.bib dosyasına kaydedilir.](https://cdn.oleafly.com/images/gifs/desktop/add-citation.gif?v=2)

## Yeni bir kaynak bulup ekleyin

Seçicideki **Yeni bir atıf bul ve ekle**'yi seçin. Şunlardan herhangi biriyle başlayın:

- `10.1145/3592979` gibi bir DOI;
- `1706.03762` gibi bir arXiv kimliği;
- bir ISBN-10 ya da ISBN-13;
- bir PubMed kimliği (PMID);
- bu tanımlayıcılardan birini içeren bir URL;
- bir makale başlığı.

DOI, arXiv, ISBN ve PubMed aramaları kendi herkese açık kataloglarını kullanır. Başlık araması, olası eşleşmeleri yazarları, yılı ve yayın yeriyle döndürür; böylece tahmini kabullenmek yerine siz seçersiniz.

Döndürülen BibTeX kaydını gözden geçirin, sonra **.bib dosyasına ekle ve atıf ver**'i seçin. Oleafly:

1. etkin kaynakçaya çakışmasız bir anahtar ekler;
2. DOI hâlihazırda varsa var olan kaydı yeniden kullanır;
3. atfı geçerli imleç konumuna ekler;
4. dosya ağacını ve Kaynaklar panelini hemen yeniler.

Üst veriler düzenlenebilir. Kayıt, metnin parçası haline gelmeden önce düzeltin.

Belge birden fazla kaynakça bildirdiğinde iletişim kutusu bir **Kaynakça** menüsü gösterir. Kayıt seçtiğiniz dosyaya gider ve Oleafly bu tercihi o proje için anımsar.

## Oleafly kaynakçayı nasıl seçer

LaTeX projeleri, etkin ana belgedeki bildirimleri izler:

- `biblatex` için `\addbibresource{references.bib}`;
- BibTeX iş akışları için `\bibliography{references}`.

Yollar, TeX araç zincirinin beklediği uzantı ve göreli yol davranışıyla çözümlenir. Eksik bir dosyaya işaret eden bildirim, sessizce başka bir yere yazmak yerine o kaynak satırda bildirilir.

Typst projeleri `#bibliography(...)` çağrısını izler; çağrı ister tek bir dosya ister liste adlandırsın, dosyalar ister BibTeX `.bib` ister Hayagriva `.yml` ve `.yaml` olsun. Yeni atıf, belgenin bildirdiği dosyaya gider. O dosya Hayagriva ise Oleafly BibTeX kaydını yazmadan önce dönüştürür. Çağrı birden fazla dosya adlandırdığında hedefi iletişim kutusunun **Kaynakça** menüsünden seçin.

Markdown projeleri, ön bilgideki `bibliography:` alanını izler.

Hiç kaynakça bildirilmediğinde Oleafly, projedeki ilk `.bib` dosyasını kullanır. Hiçbiri yoksa `references.bib` dosyasını oluşturur ve onu dosya ağacında ve atıf seçicide kullanıma sunar.

Birkaç kitaplığı olan projede, kayıt eklemeden önce seçili hedefi inceleyin.

## Typst atıf stili seçin

Bir Typst belgesinde `#bibliography(...)` çağrısı bulunduğunda, Kaynaklar panelinin **Atıflar** görünümünün alt kısmında bir **Atıf stili** menüsü görünür. Menü, projenin Typst sürümü için Typst'ın yerleşik stillerini ve projedeki `.csl` dosyalarını listeler. Bir stil seçmek, onu çağrının `style:` bağımsız değişkenine yazar. Stil yoksa Typst `ieee` kullanır.

LaTeX için stili kaynakta ayarlayın. `\bibliographystyle{`, bilinen BibTeX stillerini tamamlar; `biblatex` ile onun `style=` seçeneğini kullanın.

## Tüm bir kaynak kitaplığını içe aktarın

Kaynaklar panelinde **Kaynak kitaplığını içe aktar**'ı seçin. Bir dosyayı ya da Zotero kitaplığınızı içe aktarabilirsiniz.

**Dosyadan** seçenekte dışa aktarılmış bir kitaplık seçin:

| Kaynak biçimi | Dosya |
| --- | --- |
| BibTeX | `.bib` |
| RIS | `.ris` |
| EndNote XML | `.xml` |
| Zotero RDF | `.rdf` |

**Zotero'dan** seçenekte zotero.org hesabınızı **Ayarlar → Tümleştirmeler → Zotero** altında bir kez bağlayın, sonra Zotero kartındaki **Zotero kitaplığını içe aktar**'ı seçin. Oleafly 5.000'e kadar öğe getirir. [Araştırma kaynaklarını bağlayın](/docs/integrations/research-sources/#zotero) kurulumu adım adım anlatır.

Oleafly, kayıtları BibTeX'e eşler ve DOI'si hedef kitaplıkta ya da aynı toplu işte daha önce var olan kaynakları atlar. Çakışmasız anahtarlar oluşturur ve sonucu tek bir yazma işlemiyle ekler. İleti, kaç kaynağın eklendiğini ve kaçının hâlihazırda orada olduğunu söyler. Kitaplık içe aktarma, imleç konumuna atıf eklemez.

İçe aktarmadan sonra yeni kayıtları atıf seçicide arayın ve bir örneği özgün katalogla karşılaştırarak doğrulayın.

## Kaynak kitaplığını temizleyin

Kaynaklar paneli, dosyaları değiştirmeden önce bir temizliği önizleyebilir.

1. Projeyi açın ve Kaynaklar panelinde **Kaynak kitaplığını temizle**'yi seçin.
2. Projede birden fazla `.bib` dosyası varsa dosyayı seçin.
3. Eylem listesini ve öncesi/sonrası farkını okuyun.
4. Önerilen her anahtar yeniden adlandırmayı, kaldırılan her DOI kopyasını ve her uyarıyı inceleyin.
5. Yalnızca önizleme niyetinize uyduğunda uygulayın.

Temizleyici, anahtarları tutarlı bir yazar-yıl-başlık örüntüsüne göre yeniden adlandırır ve atıfları proje kaynak dosyaları genelinde günceller. Bir DOI kopyasını yalnızca tutulan kayıt, kaldırılan kaydın tüm alanlarını koruduğunda kaldırır. Çakışan DOI kayıtları ve benzer başlıklar tahmine dayalı olarak birleştirilmez; incelemeye işaretlenir.

Yorumlar ve BibTeX dizge tanımları korunur. Uygulama, kitaplığın hâlâ önizlemeyle eşleştiğini denetler ve dosyaları değiştirmeden önce bir yedek yazar. Büyük farklar önizlemede ilk 500 satırı gösterir; değişiklikler uygulanırken tam dosyalar yine de kullanılır.

:::caution[Uygulamadan önce inceleyin]
İki ayrı basım, çeviriler, ön baskı ve dergi sürümleri ya da benzer başlıklı makaleler bilerek ayrı olabilir. Elle bir şey birleştirmeden önce uyarıyı okuyun ve gerçek kaynakları karşılaştırın.
:::

## Kaynakları tamamlayın ve gezinin

`\cite{}`, `\citep{}`, `\citet{}`, `\parencite{}` ve `\textcite{}` gibi LaTeX atıf komutlarının içinde otomatik tamamlama, projedeki her `.bib` dosyasını arar. Typst'te `@`, anahtarları hem `.bib` hem Hayagriva dosyalarından tamamlar. Zotero bağlıyken liste, Zotero kitaplığınızı da içerir.

Örneğin asistan ya da Zotero tarafından, dosya açık değilken `.bib` dosyasına eklenmiş bir kayda yapılan atıf hemen çözümlenir. Önce belgeye bir şey yazmanız gerekmez.

- F12 ya da değiştirici tuşla tıklama, atıf anahtarından kaydına atlar.
- ⇧F12 bir kaynağın tüm kullanımlarını listeler.
- F2 bir anahtarı kaynak ve kaynakça dosyaları genelinde yeniden adlandırır.
- Üzerine gelindiğinde hedef görünür; çözümlenmemiş ya da belirsiz anahtarlar derlemeden önce işaretlenir.

[Kod zekası](/docs/code-intelligence/) tüm gezinme modelini açıklar.

## Oleafly'ye atıf verin

Oleafly bir makaleye katkı sağladıysa **Bu makalede Oleafly'ye atıf ver**'i komut paletinden ya da Kaynaklar panelinin **Atıflar** görünümünün alt kısmından çalıştırın. Oleafly, `oleafly` anahtarlı bir kaydı belgenin bildirdiği kaynakçaya ekler: BibTeX olarak ya da Hayagriva dosyası için Hayagriva olarak. Bir ileti, dosyanın adını ve kullanılacak sözdizimini (`\cite{oleafly}` ya da `@oleafly` gibi) bildirir; yanında **Geri al** bulunur. Kayıt hâlihazırda oradaysa bunun yerine anahtarın bir hatırlatıcısını alırsınız.

Kaynakça dosyası olmayan bir proje değiştirilmez; bir iletişim kutusu, kopyalayabilmeniz için kaydı gösterir. Aynı kayıt her zaman [Ayarlar → Yardım ve Hakkında](/docs/settings/help/#cite-oleafly-in-a-paper) altındadır.

## Kaynakça derlemeleri ve Biber

`biblatex` için Oleafly, derleyici kullanılabilir bir `.bbl` üretmediğinde eşleşen Biber adımını yeniden çalıştırır. Eksik bir `.bib` yolu dâhil Biber iletileri, derleme günlüğünde ve düzenleyici tanılamalarında görünür.

Biber'in kendisi başarısız olduğunda derleme günlüğü nedenini söyler. Eksik bir sistem kitaplığını adlandırır ve Biber olmadan derlemenin bir yolu olarak `\usepackage[backend=bibtex]{biblatex}` önerir. Fedora'da Oleafly'nin `.rpm` paketi, Biber'in gereksindiği iki kitaplığı önerir.

Kaynaklar tanımsız kalırsa:

1. Kaynakça bildirimini ve yolu denetleyin.
2. **Günlükler**'i açın ve ilk Biber ya da kaynakça iletisini bulun.
3. Atıf anahtarının tam bir kez bulunduğunu doğrulayın.
4. `.bib` dosyası kaydedildikten sonra yeniden derleyin.

Motora özgü kurtarma için [Derleme ve günlükler](/docs/compiling/) ile [LaTeX motorları ve paketleri](/docs/latex-engines/) sayfalarına bakın.

## Bağımsız kaynak araçları

Bir proje açmadan kaynak hazırlayabilirsiniz:

- [Atıf Oluşturucu](/docs/tools/citation-generator/) tanımlayıcıları, başlıkları, yapılandırılmış alanları ya da BibTeX'i kabul eder.
- [Kaynakça Oluşturucu](/docs/tools/bibliography-generator/) bir liste oluşturur ve doğrular.
- [Stile Göre Atıf Oluşturucuları](/docs/tools/citation-styles/) sekiz stili karşılaştırır.
- Odaklanmış araçlar [DOI'ler](/docs/tools/doi-to-bibtex/), [ISBN'ler](/docs/tools/isbn-to-bibtex/), [PubMed kimlikleri](/docs/tools/pubmed-to-bibtex/), [arXiv](/docs/tools/arxiv-citation-generator/) ve [web adresleri](/docs/tools/url-to-bibtex/) ile çalışır.

Elle düzenleme ve atıf biçimlendirme yerelde kalır. Tanımlayıcı ve başlık araması bağlantı gerektirir. [Çevrim dışı kip](/docs/settings/general/#offline-mode) bu aramaları engeller; var olan kaynakça tamamlama ve gezinme çalışmaya devam eder.

## Kanıt bulun, sonra doğrulayın

[Atıf Bul](/docs/tools/find-citations/) bilimsel dizinleri arar ya da açık taslakta destek gerektirebilecek paragrafları tarar. Atıf vermeden önce makaleyi okuyun ve her iddiayı, yöntemlerin ve sonuçların ortaya koyduğu çerçevede tutun.
