Skip to content
This repository has been archived by the owner on Jan 20, 2022. It is now read-only.

Commit

Permalink
fix website
Browse files Browse the repository at this point in the history
  • Loading branch information
c0b41 committed Oct 8, 2015
1 parent 20eb772 commit dfbc405
Show file tree
Hide file tree
Showing 6 changed files with 241 additions and 0 deletions.
69 changes: 69 additions & 0 deletions iojs-website/tr/es6-orj.md
@@ -0,0 +1,69 @@
# ES6 on io.js

io.js is built against modern versions of [V8](https://code.google.com/p/v8/). By keeping up-to-date with the latest releases of this engine we ensure new features from the [JavaScript ECMA-262 specification](http://www.ecma-international.org/publications/standards/Ecma-262.htm) are brought to io.js developers in a timely manner, as well as continued performance and stability improvements.

Version 1.1.0 of io.js ships with V8 4.1.0.14, which includes ES6 features well beyond version 3.26.33 that will be shipped with joyent/node@0.12.x.

## No more --harmony flag

On joyent/node@0.12.x (V8 3.26), the `--harmony` runtime flag enabled all **completed**, **staged** and **in progress** ES6 features together, in bulk (with the exception of nonstandard/non-harmonious semantics for `typeof` which were hidden under `--harmony-typeof`). This meant that some really buggy or even broken features like [proxies](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Proxy) were just as readily available for developers as [generators](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/function*), which had very little or even no known-issues. As such, it was best practice to either enable only certain features by using specific runtime harmony feature flags (e.g. `--harmony-generators`), or simply enable all of them and then use a restricted subset.

With io.js@1.x (V8 4.1+), all that complexity goes away. All harmony features are now logically split into three groups for **shipping**, **staged** and **in progress** features:

* All **shipping** features, the ones that V8 has considered stable, like [generators](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/function*), [templates](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/template_strings), [new string methods](https://developer.mozilla.org/en-US/docs/Web/JavaScript/New_in_JavaScript/ECMAScript_6_support_in_Mozilla#Additions_to_the_String_object) and many others are turned **on by default on io.js** and do **NOT** require any kind of runtime flag.
* Then there are **staged** features which are almost-completed features that haven't been completely tested or updated to the latest spec yet and therefore are not considered stable by the V8 team (e.g. there might be some edge cases left to discover). This is probably the equivalent of the state of [generators](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/function*) on 3.26. These are the "use at your own risk" type of features that now require a runtime flag: `--es_staging` (or its synonym, `--harmony`).
* Finally, all **in progress** features can be activated individually by their respective harmony flag (e.g. `--harmony_arrow_functions`), although this is highly discouraged unless for testing purposes.

## Which ES6 features ship with io.js by default (no runtime flag required)?


* Block scoping

* [let](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/let)

* [const](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/const)

* `function`-in-blocks

>As of v8 3.31.74.1, block-scoped declarations are [intentionally implemented with a non-compliant limitation to strict mode code](https://groups.google.com/forum/#!topic/v8-users/3UXNCkAU8Es). Developers should be aware that this will change as v8 continues towards ES6 specification compliance.
* Collections

* [Map](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Map)

* [WeakMap](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/WeakMap)

* [Set](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Set)

* [WeakSet](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/WeakSet)* [Generators](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/function*)

* [Binary and Octal literals](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Lexical_grammar#Numeric_literals)

* [Promises](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise)

* [New String methods](https://developer.mozilla.org/en-US/docs/Web/JavaScript/New_in_JavaScript/ECMAScript_6_support_in_Mozilla#Additions_to_the_String_object)

* [Symbols](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Symbol)

* [Template strings](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/template_strings)

You can view a more detailed list, including a comparison with other engines, on the [compat-table](https://kangax.github.io/compat-table/es6/) project page.

## Which ES6 features are behind the --es_staging flag?

* [Classes](https://github.com/lukehoban/es6features#classes) (strict mode only)
* [Object literal extensions](https://github.com/lukehoban/es6features#enhanced-object-literals)

* [`Symbol.toStringTag`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Symbol) (user-definable results for `Object.prototype.toString`)

## I have my infrastructure set up to leverage the --harmony flag. Should I remove it?

The current behaviour of the `--harmony` flag on io.js is to enable **staged** features only. After all, it is now a synonym of `--es_staging`. As mentioned above, these are completed features that have not been considered stable yet. If you want to play safe, especially on production environments, consider removing this runtime flag until it ships by default on V8 and, consequently, on io.js. If you keep this enabled, you should be prepared for further io.js upgrades to break your code if V8 changes their semantics to more closely follow the standard.

## How do I find which version of V8 ships with a particular version of io.js?

io.js provides a simple way to list all dependencies and respective versions that ship with a specific binary through the `process` global object. In case of the V8 engine, type the following in your terminal to retrieve its version:

```sh
iojs -p process.versions.v8
```
71 changes: 71 additions & 0 deletions iojs-website/tr/es6.md
@@ -0,0 +1,71 @@
# io.js ile ES6

io.js, [V8](https://code.google.com/p/v8/) javascript motorunun en modern sürümüyle derlenmiştir. Bu motoru güncel sürümde tutarak [JavaScript ECMA-262 tanımlayıcı dökümanı](http://www.ecma-international.org/publications/standards/Ecma-262.htm) ile belirtilmiş yeni özelliklere io.js geliştiricilerinin en kısa zamanda ulaşmasını sağlıyoruz, bu arada performans ve kararlığın arttırılmasına devam ediyoruz.

io.js 1.1.0 sürümü V8 4.1.0.14 sürümüyle gelmektedir, ayrıca joyent/node@0.12.x sürümünde bulunan V8 3.26.33 motoruna göre daha gelişmiş ES6 özelliklerine sahiptir.

## --harmony bayrağına gerek yok

joyent/node@0.12.x (V8 3.26) sürümü ile `--harmony` bayrağı tüm **tamamlanmış**, **düzenleme** ve **geliştirme** durumunda ki ES6 özellikleri aktif eder. (`--harmony-typeof` bayrağı altında gizlenen `typeof` için anlamsal standart/uyumlu olmayan istisnalarıda içerir)
Bu bayrağın belirtilmesi ile [proxies](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Proxy) gibi bazı bozuk veya hatalı özellikleri ile geliştiricilerin kullanımına hazır, az veya hiç hata belirtilmemiş [generators](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/function*) gibi özelliklerde aktif olacaktır.
Belirtilen sebeplerden ötürü en mantıklı uygulamalar, bazı özellikleri aktif etmek için özel bayraklar belirlemek (örn: `--harmony-generators`) veya tüm özellikleri etkinleştirip, daha sonra bir alt komut setini sınırlamak olacaktır.

io.js@1.x (V8 4.1+) sürümüyle beraber tüm bu karmaşıklık ortadan kalkmaktadır. Tüm ES6 (harmoni) özellikleri **taşınıyor**, **düzenleme** ve **geliştirme** olmak üzere mantıksal üç gruba ayrılmıştır. Bu özellikler;

* Tüm **taşınıyor** özellikleri V8 tarafından kararlı olarak kabul görmüş, [generators](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/function*), [templates](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/template_strings), [yeni string metodları](https://developer.mozilla.org/en-US/docs/Web/JavaScript/New_in_JavaScript/ECMAScript_6_support_in_Mozilla#Additions_to_the_String_object) gibi özellikler ile **io.js tarafından varsayılan** olarak açılmış özelliklerdir ve herhangi bir çalışma bayrağına gerek **duymazlar**.
* **düzenleme** durumunda ki özellikler testleri tamamlanmamış veya son tanımlayıcı dökümanına uygun hale getirilmemiş ve V8 takımı tarafından kararlı olarak belirtilmemiş özellikleri içerir. (örn: henüz keşfedilmemiş, araştırılmamış kısımlar olabilir). V8 3.26 sürümünde [generators](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/function*) bu duruma eşdeğer yapıdadır. Bu özellikleri kullanmakta ki riski göze alıyorsanız, `--es_staging` (veya eşanlamlısı `--harmony`) çalışma bayrağını kullanmanız gerekir.
* Yüksek ihtimalle test işlemlerinde dahi olsa sorun yaratacak, diğer tüm **geliştirme** aşamasındaki özellikleri kendilerine özel harmoni bayraklarıyla etkinleştirebilirsiniz. (örn: `--harmony_arrow_functions`)

## io.js üzerinde varsayılan olarak gelen ES6 özellikleri hangileridir (çalışma bayrağı gerektirmez) ?


* Blok alanı

* [let](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/let)

* [const](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/const)

* `function`-in-blocks

>V8 3.31.74.1 üstünde blok-alanına [özel, katı mod kodlama yapısına uyumlu olmayan sınırlama bulunmaktadır](https://groups.google.com/forum/#!topic/v8-users/3UXNCkAU8Es). Geliştiriciler bu kuralın V8 üstünde, ilerleyen dönemlerde ES6 tanımlayıcı dökümanına uyumlu yapılacak güncellemelerle değişeceğini unutmamalıdır.
* Koleksiyonlar

* [Map](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Map)

* [WeakMap](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/WeakMap)

* [Set](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Set)

* [WeakSet](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/WeakSet)* [Generators](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/function*)

* [İkili ve Sekizli Sayısal Sabitler](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Lexical_grammar#Numeric_literals)

* [Promises](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise)

* [Yeni String metodları](https://developer.mozilla.org/en-US/docs/Web/JavaScript/New_in_JavaScript/ECMAScript_6_support_in_Mozilla#Additions_to_the_String_object)

* [Semboller](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Symbol)

* [String içerisinde template kullanımı](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/template_strings)

Ayrıntılı bir liste arıyorsanız, diğer derleyici motorlarının karşılaştırıldığı [compat-tablo](https://kangax.github.io/compat-table/es6/) proje sayfasına bakabilirsiniz.

## --es_staging bayrağı ile kullanılabilen ES6 özellikleri nelerdir?

* [Classes](https://github.com/lukehoban/es6features#classes) (sadece katı modda kullanılabilir)
* [Sabit Obje Uzantıları](https://github.com/lukehoban/es6features#enhanced-object-literals)

* [`Symbol.toStringTag`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Symbol) (kullanıcı tanımlı sonuçlar için `Object.prototype.toString`)

## --harmony bayrağı kullanan bir alt yapıya sahibim. Bu bayrağı kaldırmalımıyım?

io.js üzerinde `--harmony` bayrağı sadece **düzenleme** durumunda ki özelliklleri etkinleştirir. Diğer tüm özellikler için eş değer bayrak, `--es_staging` bayrağı kullanılmalıdır. Yukarıda da belirtildiği üzere bu bayrak halen kararlı olmamış özellikleri kapsar. Eğer güvenli bir kullanım isterseniz veya üretim ortamında çalışıyorsanız, özellikler io.js üstünde ve dolayısıyla V8 üstünde varsayılan olarak kullanılana kadar bu bayrağı kaldırmayı düşünmelisiniz. Eğer bu bayrağı etkin olarak kullanmaya devam ederseniz, V8 üstünde yapılacak standartlara uygun yapısal değişikliklerde, io.js güncellemelerinin kodunuzu çalışamaz hale getirebileceğine hazırlıklı olmanız gerekmektedir.

## io.js'in hangi V8 sürümünü kullandığını nasıl bulabilirim?

io.js basit bir şekilde, tüm bağımlılıkları ve ilgili sürümleri listelemek için global `process` nesnesini sunar. V8 motorunun sürüm bilgisini öğrenebilmek için uç birim ekranına aşağıdaki komut satırını yazmanız yeterlidir:

```sh
iojs -p process.versions.v8
```
34 changes: 34 additions & 0 deletions iojs-website/tr/faq-orj.md
@@ -0,0 +1,34 @@
# FAQ

## What is io.js?

[io.js](https://github.com/iojs/io.js) is a JavaScript platform built on [Chrome's V8 runtime](http://code.google.com/p/v8/). This project began as a fork of [Joyent's Node.js™](https://nodejs.org/) and is compatible with the [npm](https://www.npmjs.org/) ecosystem.

Why? io.js aims to provide faster and predictable release cycles. It currently merges in the latest language, API and performance improvements to V8 while also updating libuv and other base libraries.

This project aims to continue development of io.js under an "[open governance model](https://github.com/iojs/io.js/blob/v1.x/GOVERNANCE.md#readme)" as opposed to corporate stewardship.

## Version 1.0.x?

io.js has moved to [Semver](http://semver.org/) and the changes between Node.js™ 0.10 and io.js 1.0.0 were significant enough
to warrant a major version increment.

Our [CHANGELOG](https://github.com/iojs/io.js/blob/v1.x/CHANGELOG.md) for v1.x provides a [summary of changes from Node.js v0.10.35 to io.js v1.0.x](https://github.com/iojs/io.js/blob/v1.x/CHANGELOG.md#summary-of-changes-from-nodejs-v01035-to-iojs-v100).

## How can I contribute?

Everyone can help. io.js adheres to a [code of conduct](https://github.com/iojs/io.js/blob/v1.x/CONTRIBUTING.md#code-of-conduct), and contributions, releases, and contributorship are under an [open governance](https://github.com/iojs/io.js/blob/v1.x/GOVERNANCE.md#readme) model.

To get started, there are open [ discussions on GitHub](https://github.com/iojs/io.js/issues), and we'd love to hear your feedback.
Becoming involved in discussions is a good way to get a feel of where you can help out further. If there is
something there you feel you can tackle, please [make a pull request](https://github.com/iojs/io.js/blob/v1.x/CONTRIBUTING.md#code-contributions).

In addition, using [Nodebug.me](http://nodebug.me/) is a good way to help Triage the issues in the backlog.

## Where do discussions take place?

There is an #io.js channel on Freenode IRC. We keep logs of the channel [here](http://logs.libuv.org/io.js/latest).

## What is open source governance?

Open source governance advocates the application of the philosophies of the open source and open content movements in order to enable any interested party to add to the creation of the end product, as with a wiki document. Legislation is democratically opened to the general citizenry, employing their collective wisdom to benefit the decision-making process and improve democracy. [[source]](https://en.wikipedia.org/wiki/Open-source_governance)
34 changes: 34 additions & 0 deletions iojs-website/tr/faq.md
@@ -0,0 +1,34 @@
# SSS

## İo.js nedir?

[io.js](https://github.com/iojs/io.js) [Chrome V8](http://code.google.com/p/v8/) üzerine inşa edilmiş bir Javascript platformudur. Proje [Joyent's Node.js™](https://nodejs.org/) klonu ve [npm](https://www.npmjs.org/) ekosistemiyle uyumlu çalışmaktadır.

## Neden?

io.js hızlı ve öngürülebilir sürümler yayınlamayı amaçlamaktadır. io.js libuv ve diğer temel kütüphaneleri güncellerken, en son V8 performans, API ve dil geliştirmelerini birleştirmektedir.

Bu proje, io.js platformunun geliştirilmesine kurumsal yönetim şekline karşı olarak "[açık yönetim modeli](https://github.com/iojs/io.js/blob/v1.x/GOVERNANCE.md#readme)" altında devam etmeyi amaçlamaktadır.

## Versiyon 1.0.x?

io.js [Semver](http://semver.org/) versiyonlama şekline geçiş yaptı ve Node.js™ 0.10 ile io.js 1.0.0 arasındaki değişiklikler bir ana sürüm yükseltilmesini
gerektirecek kadar önemliydi.

v1.x sürümleri için [CHANGELOG](https://github.com/iojs/io.js/blob/v1.x/CHANGELOG.md) dökümanı, [Node.js v0.10.35 ile io.js v1.0.x arasında ki değişiklikleri](https://github.com/iojs/io.js/blob/v1.x/CHANGELOG.md#summary-of-changes-from-nodejs-v01035-to-iojs-v100) içermektedir.

## Nasıl Katkıda Bulunabilirim?

Herkes yardımda bulunabilir. io.js bir [yönetim kılavuzuna](https://github.com/iojs/io.js/blob/v1.x/CONTRIBUTING.md#code-of-conduct) bağlı kalır, katkılar, yayınlar ve katkıda bulunma rolleri bir [açık yönetim](https://github.com/iojs/io.js/blob/v1.x/GOVERNANCE.md#readme) modeli altındadır.

Başlangıç için, [GitHub üzerinde tartışmalar](https://github.com/iojs/io.js/issues) mevcut, geri bildiriminizi duymak isteriz. Tartışmalara dahil olmak nasıl daha fazla yardımcı olabileceğiniz hakkında fikir almak için iyi bir yoldur. Eğer yapabileceğiniz bir şey varsa lütfen [pull request gönderin](https://github.com/iojs/io.js/blob/v1.x/CONTRIBUTING.md#code-contributions).

Ek olarak, [Nodebug.me](http://nodebug.me/) kullanmak birikmiş işlerin önceliğe göre sıralanmasına yardım etmek için iyi bir yoldur.

## Tartışmalar Nerede Gerçekleşiyor?

Freenode IRC üzerinde bir \#io.js kanalı mevcut. Kanalın kayıtlarını [burada](http://logs.libuv.org/io.js/latest) tutuyoruz.

## Açık Kaynak Yönetim Biçimi Nedir?

Açık kaynak yönetim biçimi; nihai ürün ortaya çıkarılırken ilgili şahısların katılımını sağlamak amacıyla açık kaynak ve açık içerik hareketlerinin felsefelerinin uygulanmasını savunmaktadır, bir wiki belgesi gibi. Mevzuat demokratik olarak herkese açıktır, karar verme süreci ve demokrasiyi geliştirmek için kolektif aklı kullanır. [[kaynak]](https://en.wikipedia.org/wiki/Open-source_governance)
21 changes: 21 additions & 0 deletions iojs-website/tr/index.md
@@ -0,0 +1,21 @@
# JavaScript I/O

[ES6](es6.html)'ı Node topluluğuna kazandırdık

[io.js](https://github.com/iojs/io.js), [node.js](https://nodejs.org/)™'e dayalı ve [npm](https://www.npmjs.org/)'le uyumlu bir platformdur.

[![io.js](../images/1.0.0.png)](https://iojs.org/dist/v1.4.1/)

[Sürüm 1.3.0](https://iojs.org/dist/v1.4.1/)

Yüklenebilir Dağıtımlar
[Linux](https://iojs.org/dist/v1.4.1/iojs-v1.4.1-linux-x64.tar.xz),
[Win32](https://iojs.org/dist/v1.4.1/iojs-v1.4.1-x86.msi), [Win64](https://iojs.org/dist/v1.4.1/iojs-v1.4.1-x64.msi),
ve [diğerleri](https://iojs.org/dist/v1.4.1/).


[Değişiklikler](https://github.com/iojs/io.js/blob/v1.x/CHANGELOG.md)

Test amaçlı olarak [gecelik derlemeleri kullanabilirsiniz](https://iojs.org/download/nightly/)

[Sık Sorulan Sorular](/tr/faq.html)
12 changes: 12 additions & 0 deletions iojs-website/tr/template.json
@@ -0,0 +1,12 @@
{
"browser-title":"io.js - JavaScript I/O",
"logo-text":"io.js",
"faq-link":"SSS",
"es6-link":"ES6",
"api-link":"API Dökümanları",
"issues-link":"GitHub Hatalar",
"org-link":"GitHub Org",
"irc-link":"IRC Chat",
"irc-logs-link":"Kayıtlar",
"gov-link":"Yönetim Modeli"
}

0 comments on commit dfbc405

Please sign in to comment.