KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #codex #typescript #ai-agents #ai-agent #cli #claude-code #open-source #deepseek-harness #dsh-plugin #python #mcp

acikkaynak-website

★ 109 Open GitHub ↗

acik-kaynak.org 1.0

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# [acikkaynak-website](https://github.com/acikkaynak/acikkaynak-website)

[![derleme durumu][build-image]][build-url]
[![kapsam durumu][coverage-image]][coverage-url]
[![lisans][license-image]][license-url]

## BENİ OKU

Bu kod tabanında, şu anda yapım aşamasında bulunan
[açık-kaynak.org](https://acik-kaynak.org/)'nun önizleme sürümü yer almaktadır.

`master` branch'ine aktarılan değişiklikler, bir dizi derleme işleminden sonra
[https://acik-kaynak.org/](https://acik-kaynak.org/) adresinde belirecektir.

## Katkı Sağlamak

### Projede kullanılan kütüphaneler

- [React](https://reactjs.org/)
- [TypeScript](https://www.typescriptlang.org/)
- [Next.js](https://nextjs.org/)
- [tailwindcss](https://tailwindcss.com/)
- [Node.js](https://nodejs.org/)
- [GitHub Actions](https://github.com/features/actions)
- [adr-tool](https://github.com/keremciu/adr-tool)
- [husky](https://typicode.github.io/husky/)

### Çalışma Ortamını Hazırlamak

`node.js`'in ve `yarn`'ın sisteminizde kurulu olduğundan emin olun.

Repository'i klonlayıp, npm üzerinden bağımlılıkları çekerek çalışma ortamınızı
hazır hale getirin.

```sh
git clone https://github.com/acikkaynak/acikkaynak-website.git
cd acikkaynak-website
yarn install
yarn dev
```

### Çalışmaya Başlamak

`yarn dev` komutu ile geliştirme modunda kod tabanına müdahale etmeye
başlayabilirsiniz. Komutu çalıştırdıktan bir süre sonra browser'ınız açılacak,
siz değişiklik yaptığınız sürece "hot reloading" sayesinde browser'daki kod
otomatik olarak güncellenecektir.

### Çalışmayı Kontrol Etmek

`yarn lint` komutu ile yazılan kodun belirlenen eslint standartlarına uyup
uymadığını kontrol edebilirsiniz. Eğer bu kontrolü yapmazsanız Pull Request
oluşturduğunuzda GitHub tarafından bu kontroller otomatik işletilecek ve açmış
olduğunuz Pull Request'i sizden güncellemenizi isteyecektir.

Bazı kod standartları otomatik olarak düzeltilebilmektedir, bunu sağlamak için
`yarn lint:fix` komutunu kullanabilirsiniz.

Aynı zamanda yazmış olduğunuz birim testlerini `yarn test` komutu ile
başlatabilirsiniz. Testler de aynı lint işlemi gibi hem pull request hem de push
esnasında GitHub Actions tarafından CI/CD otomasyonuna bağlı olarak
çalıştırılmaktadır.

## Dizin Yapısı

| Klasör                      | Açıklama                                                     |
| --------------------------- | ------------------------------------------------------------ |
| `/src/`                     | Kaynak dosyalarını içeren klasör                             |
| `/src/pages/`               | - Sayfalar ve sayfalara ait React bileşenleri                |
| `/src/pages/api/`           | - Frontend tarafında sunucu taraflı çalışması gereken kodlar |
| `/src/pages/_app.page.tsx`  | - Tüm uygulama için bağımlılık bağlantıları ve konfigurasyon |
| `/src/pages/index.page.tsx` | - Uygulamanın başlangıç sayfası                              |
| `/public/`                  | Web dizininde yer alacak tüm statik dosyalar                 |

## Yapılacaklar

[GitHub Projesi](https://github.com/orgs/acikkaynak/projects/1) üzerinde
detaylar yer almaktadır.

## Gereksinimler

- node.js (https://nodejs.org/)

## Notlar ve Teşekkürler

Webfontları içeri gömmek için
[google-webfonts-helper](https://google-webfonts-helper.herokuapp.com/)
kullanılmaktadır.

## Lisans

Apache 2.0, daha fazla detay için lütfen [LICENSE](LICENSE) dosyasını inceleyin.

## Katkı Sağlayanlar

[contributors.md](contributors.md) dosyasını inceleyebilirsiniz.

Herhangi bir katkıya açıktır. Hata düzenlemeleri, yeni özellik ve modüller
ekleyebilirsiniz.

- Koda katkı sağlamak için: Yukarıda anlatıldığı gibi repository'i klonlayın,
  değişikliklerinizi gerçekleştirin, ve bir pull request oluşturun.
- Bir hata bildirmek için: Bir şeyler ters gidiyorsa,
  [GitHub Issues](https://github.com/acikkaynak/acikkaynak-website/issues)
  üzerinden yeni bir issue oluşturup bize bildirin.

[build-image]: https://github.com/acikkaynak/acikkaynak-website/workflows/CI/badge.svg
[build-url]: https://github.com/acikkaynak/acikkaynak-website/actions?workflow=CI
[coverage-image]: https://img.shields.io/codecov/c/github/acikkaynak/acikkaynak-website.svg?style=flat-square
[coverage-url]: https://codecov.io/gh/acikkaynak/acikkaynak-website
[license-image]: https://img.shields.io/github/license/acikkaynak/acikkaynak-website.svg?style=flat-square
[license-url]: https://github.com/acikkaynak/acikkaynak-website/blob/master/LICENSE

acikkaynak-website

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README