Skip to content

Commit

Permalink
Add Docs
Browse files Browse the repository at this point in the history
  • Loading branch information
VastSea0 committed Sep 7, 2024
1 parent a43684b commit 590dc16
Show file tree
Hide file tree
Showing 5 changed files with 242 additions and 124 deletions.
9 changes: 5 additions & 4 deletions src/content/docs/docs.mdx
Original file line number Diff line number Diff line change
@@ -1,13 +1,11 @@
---

title: "Hakkında"
description: "Hüma Hakkında"
---


# Hüma Tarayıcı

Hüma açık kaynak geliştirişmiş bir web tarayıcı projedir. İlk olarak QtWebEngine sonrasında Electron kullansada güncel olarak Firefox tarayıcısının tabanı üzerine yazılmış deneysel bir tarayıcıdır. İnternette özgürlüğü ve gizliliği sağlamayaya odaklanarak geliştiriliyordur.
Hüma, açık kaynak kodlu olarak geliştirilmiş bir web tarayıcı projesidir. İlk olarak QtWebEngine, ardından Electron kullanılarak geliştirilmiş, ancak günümüzde Firefox tarayıcısının tabanı üzerine inşa edilmiş deneysel bir tarayıcıdır. Hüma, internette özgürlüğü ve gizliliği sağlamaya odaklanarak geliştirilmektedir.

:::note
Hüma, Türk mitolojisinin bir parçası olan Hüma kuşundan esinlenerek adlandırılmıştır. Hüma kuşu, cennet kuşu olarak bilinir ve cennette uçar. Hüma kuşunun üzerinden geçen kişilerin yüceleceğine ve tahta geçeceğine inanılır. Hüma tarayıcısı, Türk mitolojisinin bu özelliğini taşıyarak, kullanıcılarına yükselme ve tahta geçme fırsatı sunmayı hedefler.
Expand All @@ -21,5 +19,8 @@ Hüma Egehan KAHRAMAN tarafından 2024 yılının Ocak ayında araştırılmaya

Tarayıcı o günden bu güne İnternetin özgür kalabilmesi sürekli geliştirilmeye devam ediyor. Şu anda Hüma tarayıcısının bir ekibi yoktur, sadece Egehan KAHRAMAN tarafından geliştirilmektedir ancak bir takım kurmak ve projeyi daha büyük bir yapıya taşımak istemektedir.

## Ekran Görüntüleri
## Ekran Görüntüleri

<img src="https://raw.githubusercontent.com/VastSea0/flatpak/main/363460432-514de8f9-e6d1-43fc-b568-2bc2ce1433ae.png"/>
<img src="https://raw.githubusercontent.com/VastSea0/flatpak/main/image.png"/>
<img src="https://raw.githubusercontent.com/VastSea0/flatpak/main/image-1.png"/>
40 changes: 38 additions & 2 deletions src/content/docs/features.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -5,15 +5,34 @@ description: Hüma tarayıcısının özellikleri

## Temel özellikler

Hüma, yerli ve açık kaynaklı bir web tarayıcısıdır. Firefox tabanlı olarak geliştirilen bu tarayıcı, gizlilik odaklı tasarımı ve özelleştirilebilir özellikleriyle öne çıkar. Hüma, kendi temasının yanı sıra sayfalar arasında gezinmeyi kolaylaştıran Hüma Gezgini, dikey sekme desteği, internetsiz çalışan Hüma Tarih ve Mitoloji sayfaları, dosya paylaşımı için 10MB sınırı olan Hüma Bulut ve Türkçe söz dizimine sahip betik yazma aracı Hüma Betik gibi özellikler sunar. Pardus ekosistemine katkı sağlamayı amaçlayan Hüma, Türk mitolojisi ve tarihi hakkında da bilgi içermektedir.
### Hüma Tarayıcısı Nedir?

Hüma Tarayıcısı, kullanıcıların internet deneyimlerini daha verimli, güvenli ve kişiselleştirilmiş hale getirmek için geliştirilmiş modern bir web tarayıcısıdır. Hüma, kullanıcı dostu arayüzü ve güçlü özellikleri ile öne çıkar.

### Hüma'nın Temel Özellikleri

- **Güvenlik:** Hüma, kullanıcıların gizliliğini korumak için gelişmiş güvenlik önlemleri sunar. İzleyici engelleyici ve güvenli tarama modları ile kullanıcı verilerini korur.
- **Hız:** Hüma, hızlı ve akıcı bir tarama deneyimi sunar. Optimize edilmiş motoru sayesinde web sayfaları hızlıca yüklenir.
- **Özelleştirilebilirlik:** Kullanıcılar, tarayıcıyı kendi ihtiyaçlarına göre özelleştirebilirler. Tema seçenekleri, eklentiler ve kişiselleştirilebilir arayüz ile tarayıcıyı istedikleri gibi şekillendirebilirler.
- **Dikey Sekmeler:** Dikey sekme düzeni ile daha fazla sekme kullanımını optimize eder ve kullanıcı deneyimini iyileştirir.
- **Çalışma Alanları:** Farklı görevler ve projeler için ayrı çalışma alanları oluşturarak internet deneyimini organize eder.

### Hüma'nın Avantajları

- **Kullanıcı Dostu Arayüz:** Basit ve anlaşılır arayüzü ile herkesin kolayca kullanabileceği bir tarayıcıdır.
- **Gelişmiş Performans:** Hafif yapısı ve optimize edilmiş motoru ile yüksek performans sunar.
- **Güçlü Özellikler:** Dikey sekmeler, çalışma alanları ve Hüma Gezgini gibi özellikler ile kullanıcıların ihtiyaçlarına cevap verir.
- **Sürekli Güncellemeler:** Hüma, sürekli olarak güncellenir ve yeni özellikler eklenir. Kullanıcılar, her zaman en yeni ve en iyi deneyimi yaşarlar.

Hüma Tarayıcısı, internet deneyiminizi bir üst seviyeye taşımak için tasarlanmış güçlü ve esnek bir tarayıcıdır.

:::note
Hüma sürekli geliştirilmektedir yeni özellikleri edinmek için tarayıcının güncel olduğundan emin olun
:::

## Dikey Sekmeler

<img src="../../assets/image.png" />
<img src="https://raw.githubusercontent.com/Huma-Browser/web/7834648f158ee34a549347b08cc0d674864a8213/src/assets/image.png" />

Dikey sekmeler: Hüma Tarayıcısı için Yenilikçi Dikey Sekme Eklentisi

Expand All @@ -29,6 +48,23 @@ Dikey sekmeler, Hüma tarayıcısında kullanıcı deneyimini büyük ölçüde
- Performans Odaklı: Hafif yapısıyla tarayıcı performansını olumsuz etkilemeden kullanıcıya yüksek performans sunar.


## Çalışma Alanları

<img src="https://raw.githubusercontent.com/Huma-Browser/web/main/src/assets/workspaces.png" />

Hüma Tarayıcısı'nın çalışma alanları özelliği, kullanıcıların internet deneyimlerini organize etmelerine ve yönetmelerine yardımcı olan güçlü bir araçtır. Bu özellik, farklı görevler, projeler veya ilgi alanları için ayrı "çalışma alanları" oluşturmanıza olanak tanır.


### **Özellikler:**

- Çoklu Oturumlar: Kullanıcılar, farklı amaçlar için birden fazla çalışma alanı oluşturabilir. Örneğin, iş, kişisel araştırma ve eğlence için ayrı alanlar oluşturulabilir.

- Hızlı Geçiş: Çalışma alanları arasında kolayca geçiş yapabilme imkanı sunar. Bu, farklı görevler arasında hızlı ve verimli bir şekilde hareket etmenizi sağlar.

- Özelleştirilebilir İsimler: Her çalışma alanına özel bir isim verilebilir, böylece hangi alanın hangi amaçla kullanıldığını kolayca hatırlayabilirsiniz.

- Sekme Grupları: Her çalışma alanı, ilgili sekmeleri bir arada tutar. Bu, belirli bir projeye veya göreve ait tüm sekmeleri tek bir yerde organize etmenizi sağlar.

## Hüma Gezgini

**Hüma Gezgini:** Hüma tarayıcısının ana içeriği olarak işlev gören ve kullanıcıların farklı özellikler ve araçlar arasında geçiş yapmalarını sağlayan kapsamlı bir özelliktir.
Expand Down
10 changes: 5 additions & 5 deletions src/content/docs/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -22,10 +22,10 @@ import { Card, CardGrid } from '@astrojs/starlight/components';

<center>
<h2>Hoş Geldiniz!</h2>

</center>
<div class="container">
<img class="background-image" src="https://firebasestorage.googleapis.com/v0/b/vastsea-blog.appspot.com/o/mUj553KYSMNLQxdU68FR2cl0AFG3%2FEkran%20G%C3%B6r%C3%BCnt%C3%BCs%C3%BC%20-%202024-08-11%2005-34-59.png?alt=media&token=3f288f95-a4a2-4066-9eff-ce90cf23b23d" alt="Background" />
<img class="background-image" src="https://raw.githubusercontent.com/VastSea0/flatpak/main/363460432-514de8f9-e6d1-43fc-b568-2bc2ce1433ae.png" alt="Background" />
<div class="overlay"></div>
<div class="content">
<center>
Expand All @@ -34,13 +34,13 @@ import { Card, CardGrid } from '@astrojs/starlight/components';
</center>

<CardGrid stagger>
<Card title="Özgür ve açık kaynak" icon="pencil">
Hüma özgür yazılımdır. Kaynak kodları açıktır bu sayede kaynak kodlarını değiştirebilirsiniz
<Card title="Çalışma Alanları" icon="pencil">
Farklı görevler ve projeler için ayrı çalışma alanları oluşturun
</Card>
<Card title="Gizlilik odaklı" icon="information">
Hüma gizlilik odaklıdır, telemetri göndermez
</Card>
<Card title="Dikey sekmeler ve ek özelleştirmeler" icon="setting">
<Card title="Dikey sekmeler" icon="setting">
Tarayıcınızı dilediğiniz gibi özgürce özelleştirin
</Card>
<Card title="Kenar Çubuğu" icon="open-book">
Expand Down
224 changes: 142 additions & 82 deletions src/content/docs/reference/hüma.md
Original file line number Diff line number Diff line change
@@ -1,93 +1,153 @@
---
title: "Hüma Tarayıcısı Referans Rehberi"
description: Hüma için referans rehberi.
description: Firefox tabanlı Hüma tarayıcısı için kapsamlı referans rehberi.
---

### **Giriş**
Hüma, Firefox tabanlı açık kaynaklı bir web tarayıcısıdır. Hızlı, güvenli ve özelleştirilebilir yapısıyla kullanıcılara en iyi tarayıcı deneyimini sunar. Bu rehber, Hüma tarayıcısının özelliklerini, API işlevlerini ve kullanım detaylarını içermektedir.
# Hüma Tarayıcısı Referans Rehberi

## Giriş

Hüma, Firefox'un güçlü altyapısını kullanan özel bir web tarayıcısıdır. Firefox'un WebExtensions API'sini temel alarak, hızlı, güvenli ve özelleştirilebilir bir tarama deneyimi sunar. Bu rehber, Hüma tarayıcısının özelliklerini ve kullanılabilir API'leri detaylandırmaktadır.

## Genel Bakış

### **Genel Bakış**
- **Tarayıcı Adı:** Hüma
- **Taban:** Firefox (Gecko motoru)
- **Geliştirici:** [GitHub - Hüma Projesi](https://github.com/VastSea0/Huma)
- **Lisans:** Açık Kaynak (Mozilla Public License)

### **Özellikler**
- **Dikey Sekmeler Desteği:** Hüma Sekmeleri eklentisi ile dikey sekme düzeni.
- **Özelleştirilebilir Arayüz:** Kullanıcı dostu, kişiselleştirilebilir tema seçenekleri.
- **Güvenlik:** En güncel güvenlik protokolleri ve gizlilik araçları.

### **API Referansı**
#### **1. Tarayıcı Arayüz API’si**
- **openNewTab(url):**
- **Tanım:** Belirtilen URL’yi yeni bir sekmede açar.
- **Parametreler:** `url` (string) – Açılacak web sayfasının URL’si.
- **Geri Dönüş Değeri:** `tab` – Yeni açılan sekmenin nesnesi.
- **Örnek Kullanım:**
```javascript
var newTab = openNewTab("https://www.example.com");
```

- **closeTab(tabId):**
- **Tanım:** Belirtilen sekmeyi kapatır.
- **Parametreler:** `tabId` (number) – Kapatılacak sekmenin kimliği.
- **Geri Dönüş Değeri:** `void`
- **Örnek Kullanım:**
```javascript
closeTab(3);
```

#### **2. Kullanıcı Ayarları API’si**
- **setTheme(themeName):**
- **Tanım:** Belirtilen temayı tarayıcıya uygular.
- **Parametreler:** `themeName` (string) – Uygulanacak tema adı.
- **Geri Dönüş Değeri:** `void`
- **Örnek Kullanım:**
```javascript
setTheme("dark-mode");
```

- **getBookmarks():**
- **Tanım:** Kullanıcının yer imlerini döner.
- **Parametreler:** Yok.
- **Geri Dönüş Değeri:** `Array` – Yer imlerinin listesi.
- **Örnek Kullanım:**
```javascript
var bookmarks = getBookmarks();
```

### **Sık Sorulan Sorular (SSS)**
- **Hüma tarayıcısını nasıl özelleştirebilirim?**
- Hüma, eklentiler ve temalar aracılığıyla geniş ölçüde özelleştirilebilir. Kullanıcılar eklenti mağazasından farklı araçlar ve temalar indirebilirler.

- **Hüma tarayıcısında güvenlik nasıl sağlanıyor?**
- Hüma, Firefox’un güçlü güvenlik altyapısını kullanır ve en güncel güvenlik yamalarını içerir.

- **Hüma tarayıcısı hangi ekip tarafından geliştiriliyor?**
- Hüma, Egehan KAHRAMAN tarafından geliştiriyor. Henüz bir geliştirici ekibi yok bu nedenle tek kişi üzerinden geliştiriliyor ancak ilerleyen zamanlarda bir ekibin toplanması düşünülüyor.

- **Hüma tarayıcısında dikey sekmeleri nasıl etkinleştirebilirim?**
- Hüma Sekmeleri eklentisi Hüma Gezgini eklentisi üzerinden "Hüma Sekmelerini edin" düğmesi ile edinilebilir.

- **Hüma sadece bir tarayıcı değil derken ne kast etmek istiyorsunuz?**
- Hüma'nın sadece bir tarayıcı olmadığını aynı zamanda bir tepki olduğunu belirtmek istiyoruz. Bu tepki özgürlüğe karışmaya çalışılan şeylere verilen bir tepkidir. Kalıplaşmaya verilen bir tepkidir.
- **Hüma doğa ve küresel ısıma gibi küresel çevre sorunlarına karşı nasıl bir yol izliyor?**
- Hüma doğayı son derece önemli gören ve her şeyin başlangıcı kabul eden bir felsefeye sahiptir. Doğaya karşı açılan her savaş mağlub olmaya mahkumdur. Bu nedenle doğa ile son derece uyumlu olup; doğanın bize değil, bizim doğaya uyum sağlamamız gerektiğini savunur.
- **Hüma ilk ne zaman yazılmaya başlandı?**
- Hüma, ilk olarak 2022'de VastSea Browser adında bir deneysel olarak yazılmıştır ancak bu tarayıcı Hüma'nın değerlerini taşımadığından sadece deneysel bir iz olarak kalmıştır. Geçen zamanda ise 2023 yılında tekrardan yazılmaya başlanmış tarayıcı, geçen zamanda değer ve amaçlarını net bir şekilde belirlemiş ve bu yolda ilermeye devam etmiştir.
- **Hüma tarayıcısının amacı nedir?**
- Hüma tarayıcısı, sadece bir web tarayıcısı olmanın ötesinde, özgürlüğün ve yeniliğin simgesi olarak tasarlanmış bir projedir. Hüma'nın temel amacı, kullanıcılarına özgür bir internet deneyimi sunmaktır. Özgürlüğü savunan Hüma, her koşulda bağımsızlığı ve bireysel kararı önemser. Kalıpların ötesinde, farklı dillerin ve kültürlerin değerini vurgulayan Hüma, Türk destanlarından esinlenerek ismini almıştır. Şeffaflık ilkesini benimseyen ve açık kaynak kodlu olan Hüma, kullanıcılarına güvenilir ve açık bir platform sunar. Hüma, özgürlüğü, bağımsız düşünceyi ve şeffaflığı merkezine alarak, daha iyi bir internet deneyimi sağlamayı hedefler.

### **Kaynaklar**
- **Resmi Hüma Belgeleri:** [Hüma Belgeleri](https://github.com/VastSea0/Huma)
- **Mozilla Developer Network:** [MDN Web Docs](https://developer.mozilla.org/)
- **Taban:** Firefox
- **Motor:** Gecko (Firefox'tan)
- **Lisans:** Mozilla Public License

## Özellikler

1. **Çoklu Sekme Yönetimi:** Firefox'un güçlü sekme yönetim sistemi.
2. **Gizlilik Odaklı Tarama:** Gelişmiş izleyici koruması ve özel pencere modu.
3. **Özelleştirilebilir Arayüz:** Firefox tema desteği ve arayüz düzenleme seçenekleri.
4. **Eklenti Desteği:** Firefox eklenti ekosistemi ile uyumluluk.
5. **Hızlı Tarama:** Gecko motorunun optimize edilmiş performansı.

## API Referansı

Hüma, Firefox'un WebExtensions API'sini kullanır. İşte bazı temel API'ler:

### 1. Sekme Yönetimi API'si

#### `browser.tabs.create(createProperties)`

Yeni bir sekme açar.

- **Parametreler:**
- `createProperties` (object)
- `url` (string, opsiyonel): Açılacak URL
- `active` (boolean, opsiyonel): Sekmenin aktif olup olmayacağı
- **Geri Dönüş:** `Promise<Tab>`
- **Örnek:**
```javascript
browser.tabs.create({ url: "https://www.example.com" })
.then(tab => console.log("Yeni sekme ID:", tab.id));
```

#### `browser.tabs.remove(tabIds)`

Belirtilen sekme(leri) kapatır.

- **Parametreler:**
- `tabIds` (integer veya integer array): Kapatılacak sekme ID(leri)
- **Geri Dönüş:** `Promise<void>`
- **Örnek:**
```javascript
browser.tabs.remove(4);
// veya
browser.tabs.remove([4, 5, 6]);
```

### 2. Yer İmleri API'si

#### `browser.bookmarks.create(bookmark)`

Yeni bir yer imi oluşturur.

- **Parametreler:**
- `bookmark` (object)
- `title` (string): Yer imi başlığı
- `url` (string, opsiyonel): Yer imi URL'si
- **Geri Dönüş:** `Promise<BookmarkTreeNode>`
- **Örnek:**
```javascript
browser.bookmarks.create({
title: "Mozilla",
url: "https://mozilla.org"
}).then(bookmark => console.log("Yer imi eklendi:", bookmark.id));
```

### 3. Tema API'si

#### `browser.theme.update(windowId, theme)`

Tarayıcı temasını günceller.

- **Parametreler:**
- `windowId` (integer, opsiyonel): Tema uygulanacak pencere ID'si
- `theme` (object): Tema özellikleri
- **Geri Dönüş:** `Promise<void>`
- **Örnek:**
```javascript
browser.theme.update(undefined, {
images: {
theme_frame: "images/bg-light.png",
},
colors: {
frame: "#FFFFFF",
tab_background_text: "#000000"
}
});
```

## Eklenti Geliştirme

Hüma, Firefox eklentileri ile uyumludur. Eklenti geliştirmek için:

1. `manifest.json` dosyası oluşturun.
2. Gerekli izinleri ve API'leri belirtin.
3. Eklenti kodunuzu JavaScript kullanarak yazın.
4. Eklentiyi Hüma'ya yükleyin ve test edin.

Örnek `manifest.json`:

```json
{
"manifest_version": 2,
"name": "Hüma Örnek Eklenti",
"version": "1.0",
"description": "Hüma için örnek eklenti",
"permissions": ["tabs", "bookmarks"],
"background": {
"scripts": ["background.js"]
}
}
```

## Güvenlik ve Gizlilik

Hüma, Firefox'un güvenlik ve gizlilik özelliklerini miras alır:

- **Gelişmiş İzleyici Koruması:** Üçüncü taraf izleyicileri engeller.
- **Özel Gezinme Modu:** Geçmişi kaydetmeden gizli tarama.
- **HTTPS-Only Modu:** Güvenli bağlantıları zorlar.

## Performans İpuçları

1. Sekmeler arasında hızlı geçiş için klavye kısayollarını kullanın (örn. Ctrl+Tab).
2. Kullanılmayan eklentileri devre dışı bırakarak bellek kullanımını optimize edin.
3. İçerik engelleme için uBlock Origin gibi hafif eklentiler kullanın.

## Kaynaklar

- [Mozilla Developer Network (MDN)](https://developer.mozilla.org/)
- [Firefox Eklenti Workshop](https://extensionworkshop.com/)
- [Firefox Kaynak Kodu](https://searchfox.org/)


### **Topluluk ve Destek**
- **Forum:** [Marstakiler](https://marstakiler.vercel.app) – Hüma tarayıcı topluluğuna katılın ve sorularınıza yanıt bulun.
- **GitHub:** [Hüma Projesi GitHub](https://github.com/VastSea0/Huma) – Kod katkıları ve hata bildirimleri için.
- **GitHub:** [Hüma Projesi GitHub](https://github.com/Huma-Browser/browser) – Kod katkıları ve hata bildirimleri için.
- **Discord** [Hüma Discord](https://discord.gg/ZVHmv9dJRf) - Discord sunucumuza katılın.
---

Loading

0 comments on commit 590dc16

Please sign in to comment.