Türkçe:Başlangıç

İndirme ve Kurulum
İlk olarak, Gaia Framework MXP dosyasının son sürümünü bilgisayarınıza indirin ve kurun. Kurulum tamamlandıktan sonra, Flash'ı başlatın ve üst menüden Windows > Other Panels > Gaia Framework seçeneğini seçin. Ayrıca ASO dosyalarınızı temizlemek isteyebilirsiniz.

Herşey hazır mı? Haydi başlayalım!

Yeni Bir Gaia Projesi Yaratmak
Yeni bir Gaia projesi oluştururken ilk yapmanız gereken hangi Actionscript versiyonunu kullanacağınıza karar vermek. Create AS3 veya Create AS2 seçeneklerinden birisine tıklayın. Bu sizi Project (Proje) Panel'ine götürecek.



Project Panel (Proje Paneli)
İlk yapmanız gereken projenize bir isim vermek. Projenizin ismini istediğiniz zaman değiştirebilirsiniz, onun için şimdilik varsayılan ismi kullanabilirsiniz.

Proje Klasörü
Daha sonra projenizi oluşturacağınız bir klasör seçmelisiniz. İsterseniz bu klasörü önceden veya "Please select a project folder" button'una tıkladığınızda oluşturabilirsiniz.

Properties (Özellikler)
Projenize bir isim verdikten ve proje klasörünüzü seçtikten sonra, sıra projenizin temel özelliklerini belirlemeye geldi. Projenin boyutlarını, hizalanma şeklini, saniye/kare oranını (FPS) ve sahne rengini (stage color) ayarlayabilirsiniz. Bu değerleri daha sonra değiştirebilirsiniz ve Gaia tek tıkla bu değişiklikleri tüm Flash dosyalarınıza uygular.

Folder Paths (Klasör Yapısı)
Son adım opsiyonel. Projenizin klasör yapısını belirleyebilirsiniz. Varsayılan olarak Gaia endüstri standartlarını kullanır:

* lib - .fla dosyaları için * bin - .swf, .html, etc. dosyaları için * src - .as dosyaları için (class'lar)

Bir diğer popüler yaklaşım:

* src - .fla dosyaları için * src/classes - .as dosyaları için (class'lar) * deploy - .swf, .html, etc. dosyaları için

Başka seçenekleri de tercih edebilirsiniz. Örneğin tüm Flash dosyalarınızı "Flash" klasörüne, tüm class dosyalarınızı "flash/classes" klasörüne koyabilirsiniz. Kimi insanlar "Publish Folder" olarak "www" klasörünü tercih ederler. Gaia istediğiniz klasör isimlendirme seçeneğini kullanmanıza izin verecek kadar esnektir.

Ayrıca site.xml dosyasının da hangi klasöre koyulacağını belirleyebilirsiniz. Şimdilik bu alanı boş bırakalım.

Create New Project button'una tıklayın ve Gaia bir kaç saniye içinde projenizi oluşturacak. Sonra otomatik olarak Scaffold sekmesine geçecek. Scaffolding sekmesine geri döneceğiz. Şimdilik Gaia'nın oluşturduğu dosyalara bir göz atalım.



Proje Dosyaları


Görüldüğü gibi Gaia, Gaia panelinde folder paths bölümünde seçili klasörlerin hepsini oluşturdu.


 * lib klasörü main.fla, preload.fla dosyalarını içerir.
 * bin klasörü publish edilen tüm dosyaların gideceği klasördür.
 * src klasörü framework'ün tüm class dosyalarını içerir.
 * templates klasörü şablon fla ve class dosyalarını içerir.
 * project.gaia klasörü bir xml konfügirasyon dosyasıdır ve projeniz hakkında tüm bilgileri içerir.

bin klasörünü açın.



Şu an, index.html dosyasını, preload.swf dosyasını, site.xml dosyasını ve js isimli bir klasörü içeriyor. js klasörü ise SWFObject ve SWFAddress'i içeriyor.

index.html dosyasını açarsanız, swf dosyasının SWFObject kullanılarak sayfaya gömülmüş olduğunu göreceksiniz. Belirlediğiniz boyutlar ve hizalama seçenekleri uygulanmış olarak.

site.xml dosyasına bir göz atalım. 

Site XML
Gaia sitenin yapısını belirlemek için site.xml dosyasını kullanır.

site.xml dosyasını istediğiniz bir xml editörüyle açın. Varsayılan site.xml dosyası aşağıdaki gibidir.

   

Dallar
Gaia siteleri yapılandırmak için metafor olarak dalları (bir ağaç gibi) kullanır. Dallar her bir page id'yi birbirinden ayırmak için, klasörler ve URL'ler gibi bölü işaretini kullanır.

Yukardaki xml dosyası tek dallı ("index/nav/home") bir siteyi simgeler.

Bir dal herbiri herhangi sayıda başka page node'lar (sayfa düğümü) içerebilen, page node'lardan oluşur. Herbir page node, bu dalın bir parçası olarak yüklenecek bir swf dosyasını temsil eder.

Gaia bir dalı yüklerken, index page'inden başlayarak o dalın sonundaki page'e (terminal page) kadar tüm page'leri yükler. Yukarıdaki örnekte, "index/nav" dalını yükleyemezsiniz, çünkü "nav" kendi altında "home" adında başka bir page içeriyor. "index/nav"ı yüklemeye çalışırsanız, Gaia otomatik olarak "index/nav/home"u yükler (o dalın tamamını). Bu davranışı page node'undaki landing (iniş) özelliğini kullanarak değiştirebilirsiniz.

site.xml node'ları ve özellikleri hakkında detaylı bilgiyi dokümantasyonun Site XML Dosyası bölümünde bulabilirsiniz.

XML Ağaç Yapısı
site.xml dosyasını özelleştirmeye başlamadan önce, yapısına ve Gaia'nın içeriği yüklemesiyle nasıl bağlantılı olduğuna bakalım. Gaia dosyaları bir dalın tepesinden başlayarak sırayla hiyerarşide aşağı doğru giderek yükler. Dolayısıyla index page node'u en alta yüklenen swf'yken, dalın en aşağısındaki page node en üste yüklenen swf'dir. Bu davranışı aşağıda anlatılan depth (derinlik) özelliğini kullanarak değiştirebilirsiniz..

Site Node'u
site.xml'in root (kök) node'u dir. node'unun belirlenmesi zorunlu bir özelliği yoktur. Opsiyonel title (başlık) ve menu özellikleri sizin için ayarlanmıştır.

Index Page (Index Sayfası)
node'unun ilk alt node'u id'si index olan (id="index") node'udur. Gaia'nın birkaç kuralından birisi, ilk page'i "index" olarak adlandırmaktır.

"index" page iki sebepten dolayı özeldir. Başka bir page yüklenmeden kendisini yüklemesi ve geçiş efektinin gerçekleşmesi sağlanabilir. Ayrıca varsayılan olarak diğer her page'in altına yüklenir.

Pages (Sayfalar)
Şablon site.xml dosyasında "index" page'in ilk alt page'inin id'si "nav"dır. "nav" page'i global navigasyon sistemi olarak ayarlanmıştır. Diğer tüm page'lerin üzerine yüklenir, çünkü opsiyonel "depth" (derinlik) özelliği "top"a (üst) ayarlanmıştır. Daha da önemlisi, bu konfigürasyonda daima yüklenir, çünkü "index" page'inin tek alt page'idir. Dolayısıyla altında yer alan her dalın bir parçasıdır.

Örneğimizdeki dalda, bir sonraki page son page olan "home"dur. title özelliği "Home" olarak belirlenmiştir. Tarayıcının başlık çubuğunda, site node'unun title özelliğinde %PAGE% yazılı yerler yerine Home gözükecektir. Bu ayrıca dalın son page'i olduğu için "terminal page" olarak bilinir.

Tarayıcının başlık çubuğunda, bir dalın sadece terminal page'inin (veya landing özelliği true olarak belirlenmiş (landing="true") page'ler) ismi görülür. Dolayısıyla bir dalda sadece terminal page'e title özelliği atamanız yeterlidir.

Ön yükleyici, o an yüklediği sayfanın title özelliğini progress event'ine (ilerleme olayı) gönderir. Bu sebeple her page'e title özelliği koymak isterseniz, bunu yapabilirsiniz. Bu konuyla ilgili daha fazla bilgi dokümantasyonun Ön Yükleyici bölümünde yer almaktadır.

Site XML'e Sayfalar (Pages) Eklemek
Tek bir daldan oluşan bir site pek de site sayılmaz. Haydi birkaç sayfa daha ekleyelim!

       

Şimdi kocaman üç dalımız oldu:


 * 1) "index/nav/people/friends"
 * 2) "index/nav/people/family/tree"
 * 3) "index/nav/home"

Herbir dalda son page'in title'ı olduğuna, node'u ve bazı page node'larının "menu" isimli bir özelliğe sahip olduğuna dikkat edin.

Eğer sağ tıkladığınızda çıkan menünün, sitede navigasyonu sağlamasını istiyorsanız, site node'una "menu" özelliğini ekleyin ve değerini "true" olarak belirleyin.

Eğer herhangi bir page'in linkinin bu sağ tıkla çıkan menüde gözükmesini istiyorsanız, o page'e "menu" özelliğini ekleyin ve değerini "true" olarak belirleyin ayrıca page'e bir title verin.

Not: title özelliği verilmemiş page'ler sağ tık menüsünde gözükmeyecektir.

Ayrıca gördüğünüz gibi, family page node'unun "menu" özelliği "true" olarak ayarlanmış ama daldaki son page o değil. Sorun değil çünkü, Gaia sağ tık menüsünde "Family"yi gösterecek fakat "Family"ye tıklandığında "index/nav/people/family/tree" yüklenecek.

Tamam. Test sitemize scaffold (sitenin iskeletini oluşturma) işlemi uygulamaya yeterli bir site yapısı oluştu. Yukarıdaki xml'i kopyalayın ve site.xml dosyanızdaki herşeyi silip kopyaladığınız xml'i site.xml dosyanıza yapıştırın. site.xml dosyanızı kaydedin.

Scaffolding (Sitenin İskeletini Oluşturma)
Tamam, şimdi işin en heyecanlı kısmına geldik. Scaffolding (sitenin iskeletini oluşturma)!

Class Package (Sınıf Paketi)
Flash'a geri dönün. Gaia Framework panelinde Scaffold sekmesi zaten seçili olmalı. Üstte Class Package isimli yazı alanında "pages" yazılı.

Eğer class package'larının ne olduğunu bilmiyorsanız, endişelenmeyin çünkü çok kolay. Temel kural şu: Müşterinizin web site adresini alın, ters çevirin, ve sonuna projenin ismini ekleyin.

Örneğin müşterinizin web site adresi company.com olsun. Projenin adı da website. Class package şu şekilde olmalı:

com.company.website

Gaia projelerinizde, class package'ın sonuna "pages" eklemeniz tavsiye edilmektedir. Class package'ın yeni hali aşağıdaki gibi olur.

com.company.website.pages

Şimdilik class package'ı varsayılan değeri "pages"da bırakalım.

Scaffold Project (Projenin İskeletini Oluştur)
Şimdi tek yapmanız gereken, Scaffold Project button'una basmak. Kalan her şeyi Gaia sizin için yapacak.

Gaia Scaffolding, sitenizin tüm FLA dosyalarını, site.xml dosyanızdaki swf isimlerini baz alarak oluşturur. SWF dosyalarının publish edileceği klasörü (bin) ayarlar, tüm page dosyalarını Publish paneline ekler, her page için bir class dosyası yaratır ve FLA dosyasının document class'ı olarak bu class'ı ayarlar. AS2 scaffolding, swf dosyalarının boyutunu büyük oranda azaltmak için, her Flash sayfası için bir exclude.xml dosyası oluşturur.

Tüm site dosyaları oluşturulduktan sonra, Publish sekmesi aktif hale gelir, Gaia tüm siteyi publish eder ve main.fla dosyasını çalıştırır..

Sağ tık menüsünü kullanarak siteyi gezebilir ve bölümler arası geçişleri görebilirsiniz.

Şimdi bin ve lib klasörlerini açabilir, tüm Flash ve swf dosyalarını görebilirsiniz. src klasörünün içindeki pages klasörünü açarak, Gaianın oluşturduğu tüm page class'larını görebilirsiniz.

Tebrikler, ilk Gaia Framework sitenizi sadece birkaç dakika içerisinde oluşturdunuz

Şimdi Sayfalar bölümüne geçip, Gaia'nın nasıl çalıştığını daha iyi öğrenmenin tam zamanı.