Universe
Create project in app

Necmettin Erbakan Üniversitesi Eğitim Bilimleri Enstitüsü lisansüstü eğitim için RESMÎ OLMAYAN tez önerisi, tez ve dönem projesi şablonudur. [UNOFFICIAL thesis proposal, thesis and term project template for graduate education at Necmettin Erbakan University Institute of Educational Sciences.]

İçindekiler [Table of Contents]

İçindekileri göstermek/gizlemek için tıklayınız [Click to show/hide the Table of Contents]

Resmî Şablon Hakkında [About the Official Template]

Necmettin Erbakan Üniversitesi Eğitim Bilimleri Enstitüsü lisansüstü eğitim için RESMÎ tez önerisi, tez ve dönem projesi şablonları Typst ve LaTeX formatında bulunmamakta olup yalnızca “docx” uzantılı Microsoft Word şablonları bulunmaktadır. [Necmettin Erbakan University Institute of Educational Sciences does not have OFFICIAL thesis proposal, thesis and term project templates for graduate education in Typst and LaTeX format and only Microsoft Word templates with “docx” extension are available.]

Resmî kılavuz ve şablonlar aşağıdaki verilen bağlantılarda yer almaktadır: [Official guidelines and templates are available at the links provided below:]

Ön İzleme Görselleri [Thumbnails]

Türkçe [Turkish]

     

İngilizce [English]

     

Örnek Çıktılar [Sample Outputs]

Türkçe [Turkish]

İngilizce [English]

Türkçe [Turkish]

Teşekkür

Bu proje yazılmadan önce ve sonrasında aşağıdaki projeler incelenerek bazı durumlarda fikir almak için yararlanılmıştır:

Bu projelerde emeği geçen herkese çok büyük teşekkürlerimi sunarım.

Ve ayrıca Typst YouTube Oynatma Listesi için <@isaacew>'e büyük teşekkürlerimi sunarım.

Kullanılan Paketler

Bu projelerde emeği geçen herkese çok büyük teşekkürlerimi sunarım.

Özellikler

  • [x] Tek şablonda tez, tez önerisi ve dönem projesi yazılabilir. Örneğin, tez önerinizi bitirdikten sonra bunun koddaki şablon ayarları kısmını (#show: template-configurations.with(...)) yorum satırı yaparak pasif hale getirdikten sonra tez için yeni bir şablon ayarı oluşturarak tezinizi yazmaya devam edebilirsiniz. Böylece, tek projede hem tez önerinizi hem de tezinizi yazabilir ve istediğiniz zaman istediğiniz çıktıyı elde edebilirsiniz.
  • [x] ~%99 oranında otomatik olarak şablon kurallarına uygun olarak içeriği düzenler. Otomatik olarak henüz yapılamayan bazı durumlar aşağıdaki gibidir:
    • [ ] Şekillerin içerisinde alt şekillerin koyulması. Bu özellik için gerekli altyapının sağlanması beklenmektedir. Bunu yapmak için şimdilik subpar Typst Universe paketi kullanılabilir.
    • [ ] Tablo başlıkları otomatik olarak tekrar edememekte ve tekrar eden başlıkların ana başlıktan farklı olamamaktadır. Figür başlıklarının tekrar etmesi ve tekrar eden başlıkların ana başlıktan farklı olmasını sağlayacak özellikler gelene kadar tablolar bölünemez şeklinde kalmalıdır. Bu özellik için gerekli altyapının sağlanması beklenmektedir. Bunu yapmak için, şimdilik özel fonksiyon oluşturulabilir (Bakınız: https://github.com/typst/typst/issues/5057#issuecomment-2399903391).
    • [ ] Tabloların başlık satırlarının koyu yazılması sadece tablonun ilk satırı için otomatik olarak olmaktadır. Eğer tablonun başlık kısmı iki ya da daha fazla satırdan oluşuyorsa bu satırların içeriği elle (manuel) olarak koyu yazılması gerekmektedir. İleriki Typst sürümlerinde bunun otomatik olarak yapılması için gerekli altyapının sağlanması beklenmektedir.
    • [ ] Tabloların başlık kısmının üstündeki ve altındaki kenarlıklar otomatik olarak koyulmaktadır. Eğer tablonun başlık kısmı iki ya da daha fazla satırdan oluşuyorsa bu satırların arasındaki kenarlıkların elle (manuel) olarak koyulması gerekmektedir. İleriki Typst sürümlerinde bunun otomatik olarak yapılması için gerekli altyapının sağlanması beklenmektedir.
    • [ ] Tablonun açıklamasının yer aldığı son satırın genişliğinin yani kaç sütunun birleşimi kadar olacağını elle (manuel) olarak belirtmek gerekmektedir. İleriki Typst sürümlerinde bunun otomatik olarak yapılması için gerekli altyapının sağlanması beklenmektedir.
    • [ ] Tablonun açıklamasının yer aldığı son satırın altındaki kenarlığın elle (manuel) olarak kaldırılması gerekmektedir. İleriki Typst sürümlerinde bunun otomatik olarak yapılması için gerekli altyapının sağlanması beklenmektedir.
    • [ ] Tablonun açıklamasının yer aldığı son satırın içeriğinin sola hizalanmasını elle (manuel) olarak belirtmek gerekmektedir. İleriki Typst sürümlerinde bunun otomatik olarak yapılması için gerekli altyapının sağlanması beklenmektedir.
  • [x] Tablo, şekil ve kod figürlerinin otomatik olarak numaralandırılması sağlanmaktadır. Araya yeni bir figür eklendiğinde numaralandırma otomatik olarak güncellenmektedir. Aynı şekilde, bu figürlere metin içinde yapılan atıflardaki numaralandırmalar da otomatik olarak güncellenmektedir.
  • [x] Çoklu dil desteği (Türkçe ve İngilizce) vardır.
  • [x] Açılır liste mantığında tanımlanmış bilgiler içerisinden seçim yapılabilmesi sağlanarak hata yapılması ihtimalini azaltmak.

Kullanım

Kullanmaya Başlamak

Öncelikle, şablonu projeniz için içe aktarınız. Daha sonra, şablon ayarlarını giriniz.

NOT: Şablonu Kurulum başlığında bahsedildiği gibi kullandığınızda bu kısım otomatik olarak mevcut olacaktır. Sadece şablon ayarlarındaki bilgileri projenize göre güncellemeniz yeterlidir. Şablon ayarlarında yer alan parametrelerin değerlerinin nasıl girileceğiyle ilgili açıklamalar ilgili parametrenin bir üstündeki satırda yorum satırı olarak yer almaktadır.

Kodu göstermek/gizlemek için tıklayınız 
// Şablonu, Kurulum başlığında bahsedilden durumlardan size uygun olana göre içe aktarınız:
#import "@preview/utype-neuies-reports:1.0.0": (
  template-configurations,
  LANGUAGES,
  REPORT-TYPES,
  DEPARTMENTS,
  PROGRAMS,
  ACADEMIC-MEMBER-TITLES,
)
// NOT: Yukarıdaki durumlarda olduğu gibi içe aktarılan değişkenleri tek tek belirtmek yerine `#import "@preview/utype-neuies-reports:1.0.0": *` şeklinde tüm değişkenleri içe aktararak da yapabilirsiniz.

// Şablon ayarlarını giriniz.
#show: template-configurations.with(
  ...
)

Şablon Yapısı

Aşağıdaki şemada şablon yapısını yer almaktadır. Burada, şablondaki klasör ve dosyaların hiyerarşik biçimde görebilirsiniz.

Şemayı göstermek/gizlemek için tıklayınız 
template/                                                       <-- Şablon klasörü
├── assets/                                                     <-- Varlık dosyaları
│   ├── bibliography-sources/                                   <-- Kaynakça kaynakları
│   │   └── references.bib
│   ├── csv-files/                                              <-- CSV veri dosyaları
│   │   └── csv-table-data.csv
│   ├── examples/                                               <-- Örnek dosyalar
│   │   ├── code-figure-example.typ
│   │   ├── image-figure-example.typ
│   │   ├── math-equation-example.typ
│   │   ├── quotation-example.typ
│   │   ├── table-figure-example.typ
│   │   └── table-figure-from-csv-example.typ
│   ├── images/                                                 <-- Görsel dosyaları
│   │   └── sample-image.png
│   └── languages/                                              <-- Dil yapılandırması
│       ├── english.toml
│       └── turkish.toml
└── sections/                                                   <-- Rapor bölümleri
    ├── 01-front/                                               <-- Ön kısım
    │   ├── abbreviations-text.typ
    │   ├── abstract-text-eng.typ
    │   ├── abstract-text-tur.typ
    │   ├── preface-text.typ
    │   └── symbols-text.typ
    ├── 02-main/                                                <-- Ana kısım
    │   ├── 01-introduction/                                    <-- Giriş alt kısmı
    │   │   ├── assumptions-text.typ
    │   │   ├── definitions-text.typ
    │   │   ├── introduction-text.typ
    │   │   ├── limitations-text.typ
    │   │   ├── statement-of-the-problem-text.typ
    │   │   └── the-purpose-of-the-study-text.typ
    │   ├── 02-literature-review/                               <-- Alan Yazın (İlgili Literatür) alt kısmı
    │   │   └── literature-review-text.typ
    │   ├── 03-methodology/                                     <-- Yöntem alt kısmı
    │   │   ├── data-analysis-text.typ
    │   │   ├── data-collection-process-text.typ
    │   │   ├── data-collection-tools-text.typ
    │   │   ├── methodology-text.typ
    │   │   ├── research-populations-and-sample-text.typ
    │   │   └── research-method-text.typ
    │   ├── 04-findings/                                        <-- Bulgular alt kısmı
    │   │   └── findings-text.typ
    │   └── 05-discussion-conclusion-and-suggestions/           <-- Tartışma, Sonuç ve Öneriler alt kısmı
    │   │   ├── conclusion-text.typ
    │   │   ├── discussion-conclusion-and-suggestions-text.typ
    │   │   ├── discussion-text.typ
    │   │   └── suggestions-text.typ
    └── 03-back/                                                <-- Arka kısım
        ├── expanded-turkish-abstract-text.typ                  <-- Genişletilmiş Türkçe Özet alt kısmı
        └── appendices/                                         <-- Ekler alt kısmı
            ├── appendices-text.typ
            ├── appendix-1-text.typ
            └── appendix-2-text.typ
└── main.typ                                                    <-- Şablondan oluşturmaya başlama dosyası

Alternatiflere sahip başlıklardaki alternatiflerden birini seçmek.

Türkçe dilindeki başlıklar için /template/assets/languages/turkish.toml, İngilizce dilindeki başlıklar için /template/assets/languages/english.toml dosyasını açınız. Ardından, kullanmak istediğiniz başlık dışındaki başlıkları siliniz.

Örneğin, /template/assets/languages/turkish.toml dosyasında şu şekilde bir değişiklik yapılarak istenen başlık seçilebilir:

Kodu göstermek/gizlemek için tıklayınız 
[translations]
# Başlıklardan sadece birini kullanmak için parantez içinde olmayan ya da parantez içindeki ifadelerden birini seçip diğerlerini siliniz.
# Seçmeden önce:
#PREFACE = "ÖN SÖZ (TEŞEKKÜR)"
# Seçtikten sonra:
PREFACE = "ÖN SÖZ"

Kurulum

Gerekli Yazılımlar

  • Typst.app: Typst’ın resmi kod düzenleyicisidir.

    YA DA

  • Visual Studio Code: Typst kodlarını yazmak için kullanılabilen bir kod düzenleyicisidir.

  • Tinymist Typst Visual Studio Code Uzantısı: Typst kodlarını yazarken yardımcı olan, eş zamanlı olarak çıktıyı görüntüleme imkânı sağlayan ve çıktıyı desteklenen formatlarda oluşturabilen bir uzantıdır.

Çevrim İçi

Şablonu Typst.app Web Sitesinden Kullanmak

Bu durumda internete her zaman bağlı olmanız gerekmektedir.

Şablonu Tinymist Typst Visual Studio Code Uzantısıyla Kullanmak

Bu durumda, ilk defa şablonu indirirken internete ihtiyaç vardır. İlk indirme işleminden sonra internete bağlı olmadan kullanılabilir ve şablonun farklı bir sürümünü indirmek veya yeni bir sürümüne geçmek istediğinizde anlık olarak internete ihtiyaç vardır. Sonrasında internete bağlı olmadan kullanmaya devam edilebilir.

Şablonu yukarıda bahsedilen araçlarla çevrim içi kullanmak için aşağıdaki gibi içe aktarma yapabilirsiniz:

NOT: Tinymist Typst uzantısının 'Template Gallery’si üzerinden bir şablonu seçerek proje oluşturduğunuzda bu şekilde içe aktarma yapabilirsiniz.

Kodu göstermek/gizlemek için tıklayınız 
#import "@preview/utype-neuies-reports:1.0.0": (
  template-configurations,
  LANGUAGES,
  REPORT-TYPES,
  DEPARTMENTS,
  PROGRAMS,
  ACADEMIC-MEMBER-TITLES,
)
// NOT: Yukarıdaki durumlarda olduğu gibi içe aktarılan değişkenleri tek tek belirtmek yerine `#import "@preview/utype-neuies-reports:1.0.0": *` şeklinde tüm değişkenleri içe aktararak da yapabilirsiniz.

Çevrim Dışı

Şablonu çevrim dışı kullanmak için Tinymist Typst Visual Studio Code uzantısını kullanabilirsiniz.

Şablonu adresindeki bahsedilen konuma indirerek kullanıyorsanız aşağıdaki gibi içe aktarma yapabilirsiniz:

Kodu göstermek/gizlemek için tıklayınız 
#import "@local/utype-neuies-reports:1.0.0": (
  template-configurations,
  LANGUAGES,
  REPORT-TYPES,
  DEPARTMENTS,
  PROGRAMS,
  ACADEMIC-MEMBER-TITLES,
)
// NOT: Yukarıdaki durumlarda olduğu gibi içe aktarılan değişkenleri tek tek belirtmek yerine `#import "@local/utype-neuies-reports:1.0.0": *` şeklinde tüm değişkenleri içe aktararak da yapabilirsiniz.

Şablonu, şablonun bütün dosyalarının bulunduğu geliştiricinin GitHub deposu üzerinden manuel olarak bilgisayarınızda istediğiniz herhangi bir konuma indirerek kullanıyorsanız aşağıdaki gibi içe aktarma yapabilirsiniz:

Kodu göstermek/gizlemek için tıklayınız 
#import "/src/lib.typ": (
  template-configurations,
  LANGUAGES,
  REPORT-TYPES,
  DEPARTMENTS,
  PROGRAMS,
  ACADEMIC-MEMBER-TITLES,
)
// NOT: Yukarıdaki durumlarda olduğu gibi içe aktarılan değişkenleri tek tek belirtmek yerine `#import "/src/lib.typ": *` şeklinde tüm değişkenleri içe aktararak da yapabilirsiniz.

İngilizce [English]

Acknowledgement

Before and after writing this project, the following projects were examined and in some cases used for ideas:

I sincerely thank everyone who contributed to these projects.

And also a big thank you to <@isaacew> for Typst YouTube Playlist. It was very helpfull to start Typst.

Packages Used

I sincerely thank everyone who contributed to these projects.

Features

  • [x] It can be written thesis, thesis proposal and term project in a single template. For example, after completing your thesis proposal, you can comment out the template settings section in the code (#show: template-configurations.with(...)) and create a new template setting for the thesis and continue writing your thesis. Thus, you can write both your thesis proposal and your thesis in a single project and get the output you want at any time.
  • [x] It automatically arranges the content in accordance with the template rules at a rate of ~%99. Some situations that cannot be done automatically yet are as follows:
    • [ ] Placing sub-figures inside figures. The necessary infrastructure is expected to be provided for this feature. For now, the subpar Typst Universe package can be used to do this.
    • [ ] Table captions cannot repeat automatically and repeated captions cannot be different from the main caption. Tables should remain non-splittable until there are features that allow figure captions to repeat and repeat captions to be different from the main caption. The necessary infrastructure is expected to be provided for this feature. For now, a custom function can be created to do this (see: https://github.com/typst/typst/issues/5057#issuecomment-2399903391).
    • [ ] Writing the header lines of tables in bold is only done automatically for the first line of the table. If the header part of the table consists of two or more lines, the content of these lines must be written in bold manually. The necessary infrastructure is expected to be provided in future versions of Typst to do this automatically.
    • [ ] The borders above and below the header part of the tables are automatically put in bold. If the header part of the table consists of two or more lines, the borders between these lines must be put in bold manually. The necessary infrastructure is expected to be provided in future versions of Typst to do this automatically.
    • [ ] It is necessary to manually specify the width of the last line containing the description of the table, that is, how many columns will be combined. The necessary infrastructure is expected to be provided in future versions of Typst to do this automatically.
    • [ ] The bottom border of the last line containing the description of the table must be removed manually. The necessary infrastructure is expected to be provided in future versions of Typst to do this automatically.
    • [ ] It is necessary to manually specify that the content of the last line containing the description of the table is left-aligned. The necessary infrastructure is expected to be provided in future versions of Typst to do this automatically.
  • [x] Automatic numbering of table, image and code figures is provided. The numbering is automatically updated when a new figure is inserted. Likewise, the numbering of references to these figures in the text is also automatically updated.
  • [x] Multi-language support (Turkish and English) is available.
  • [x] Reducing the possibility of making mistakes by providing the ability to choose from the information defined in the logic of the drop-down list.

Usage

Getting Started

First, import the template for your project. Then, enter the template configurations.

NOTE: When you use the template as mentioned in the Installation section, this part will be automatically available. You only need to update the information in the template configurations according to your project. Explanations on how to set the values of the parameters in the template configurations are given as a comment line on the line above the relevant parameter.

Click to show/hide the code 
// Import the template according to the appropriate situation mentioned in the Installation section:
#import "@preview/utype-neuies-reports:1.0.0": (
  template-configurations,
  LANGUAGES,
  REPORT-TYPES,
  DEPARTMENTS,
  PROGRAMS,
  ACADEMIC-MEMBER-TITLES,
)
// NOTE: As in the above cases, instead of specifying the imported variables individually, you can also do it by importing all variables as `#import "@preview/utype-neuies-reports:1.0.0": *`.

// Enter the template configurations.
#show: template-configurations.with(
  ...
)

Template Structure

The diagram below shows the template structure. Here you can see the hierarchical format of folders and files in the template.

Click to show/hide the diagram 
template/                                                       <-- Template directory
├── assets/                                                     <-- Asset files
│   ├── bibliography-sources/                                   <-- Bibliography sources
│   │   └── references.bib
│   ├── csv-files/                                              <-- CSV data files
│   │   └── csv-table-data.csv
│   ├── examples/                                               <-- Example files
│   │   ├── code-figure-example.typ
│   │   ├── image-figure-example.typ
│   │   ├── math-equation-example.typ
│   │   ├── quotation-example.typ
│   │   ├── table-figure-example.typ
│   │   └── table-figure-from-csv-example.typ
│   ├── images/                                                 <-- Image files
│   │   └── sample-image.png
│   └── languages/                                              <-- Language configuration
│       ├── english.toml
│       └── turkish.toml
└── sections/                                                   <-- Report sections
    ├── 01-front/                                               <-- Front section
    │   ├── abbreviations-text.typ
    │   ├── abstract-text-eng.typ
    │   ├── abstract-text-tur.typ
    │   ├── preface-text.typ
    │   └── symbols-text.typ
    ├── 02-main/                                                <-- Main section
    │   ├── 01-introduction/                                    <-- Introduction subsection
    │   │   ├── assumptions-text.typ
    │   │   ├── definitions-text.typ
    │   │   ├── introduction-text.typ
    │   │   ├── limitations-text.typ
    │   │   ├── statement-of-the-problem-text.typ
    │   │   └── the-purpose-of-the-study-text.typ
    │   ├── 02-literature-review/                               <-- Literature review subsection
    │   │   └── literature-review-text.typ
    │   ├── 03-methodology/                                     <-- Methodology subsection
    │   │   ├── data-analysis-text.typ
    │   │   ├── data-collection-process-text.typ
    │   │   ├── data-collection-tools-text.typ
    │   │   ├── methodology-text.typ
    │   │   ├── research-populations-and-sample-text.typ
    │   │   └── research-method-text.typ
    │   ├── 04-findings/                                        <-- Findings subsection
    │   │   └── findings-text.typ
    │   └── 05-discussion-conclusion-and-suggestions/           <-- Discussion, conclusion and suggestions subsection
    │   │   ├── conclusion-text.typ
    │   │   ├── discussion-conclusion-and-suggestions-text.typ
    │   │   ├── discussion-text.typ
    │   │   └── suggestions-text.typ
    └── 03-back/                                                <-- Back section
        ├── expanded-turkish-abstract-text.typ                  <-- Expanded Turkish Abstract subsection
        └── appendices/                                         <-- Appendices subsection
            ├── appendices-text.typ
            ├── appendix-1-text.typ
            └── appendix-2-text.typ
└── main.typ                                                    <-- Entry point file to start building from template

Selecting one of the alternatives in headings with alternatives

For Turkish language headings, open the /template/assets/languages/turkish.toml file. For English language headings, open the /template/assets/languages/english.toml file. Then, delete all headings except the one you want to use.

For example, in the /template/assets/languages/turkish.toml file, you can select the desired heading by making the following change:

Click to show/hide the code 
[translations]
# To use only one of the headings, select either the expression not in parentheses or one of the expressions in parentheses and delete the others.
# Before selection:
#PREFACE = "PREFACE (ACKNOWLEDGEMENTS)"
# After selection:
PREFACE = "PREFACE"

Installation

Required Softwares

Online

Using the Template from the Typst.app Website

In this case, you need to be connected to the internet at all times.

Using the Template with the Tinymist Typst Visual Studio Code Extension

In this case, you need the internet when downloading the template for the first time. After the first download, it can be used without being connected to the internet, and you need the internet momentarily when you want to download a different version of the template or switch to a new version. Afterwards, you can continue to use it without being connected to the internet.

To use the template online with the tools mentioned above, you can import it as follows:

NOTE: When you create a project by selecting a template from the ‘Template Gallery’ of the Tinymist Typst extension, you can import it in this way.

Click to show/hide the code 
#import "@preview/utype-neuies-reports:1.0.0": (
  template-configurations,
  LANGUAGES,
  REPORT-TYPES,
  DEPARTMENTS,
  PROGRAMS,
  ACADEMIC-MEMBER-TITLES,
)
// NOTE: As in the above cases, instead of specifying the imported variables individually, you can also do it by importing all variables as `#import "@preview/utype-neuies-reports:1.0.0": *`.

Offline

You can use the Tinymist Typst Visual Studio Code extension to use the template offline.

If you are using the template by downloading it to the location mentioned here, you can import it as follows:

Click to show/hide the code 
#import "@local/utype-neuies-reports:1.0.0": (
  template-configurations,
  LANGUAGES,
  REPORT-TYPES,
  DEPARTMENTS,
  PROGRAMS,
  ACADEMIC-MEMBER-TITLES,
)
// NOTE: As in the above cases, instead of specifying the imported variables individually, you can also do it by importing all variables as `#import "@local/utype-neuies-reports:1.0.0": *`.

If you are using the template by manually downloading it to any location on your computer from the developer’s GitHub repository where all the template files are located, you can import it as follows:

Click to show/hide the code 
#import "/src/lib.typ": (
  template-configurations,
  LANGUAGES,
  REPORT-TYPES,
  DEPARTMENTS,
  PROGRAMS,
  ACADEMIC-MEMBER-TITLES,
)
// NOTE: As in the above cases, instead of specifying the imported variables individually, you can also do it by importing all variables as `#import "/src/lib.typ": *`.