Extension:Page Forms/Hızlı başlangıç kılavuzu

From mediawiki.org
This page is a translated version of the page Extension:Page Forms/Quick start guide and the translation is 100% complete.

Böylece, sitenizdeki tüm yazılımları kurdunuz. Şimdi ne olacak? Şimdi verilerinizi tutmak, görüntülemek ve eklemek ve düzenlemek için yapılar oluşturma zamanı; Neyse ki tüm bunlar sadece çeşitli viki sayfaları oluşturarak yapılabilir.

İlk adım veri yapınızı bulmak olmalıdır. Site ne tür sayfalara sahip olacak? Her birinde hangi veriler bulunacak? Tüm bunları daha sonra değiştirebilirsiniz, ancak bir başlangıç planınız olmalıdır. Bunu aldıktan sonra (ideal olarak, yazılmıştır), gerekli viki sayfalarını oluşturmaya devam edebilirsiniz. Şablonlar ve formlar, muhtemelen kategoriler ve (Semantic MediaWiki kullanıyorsanız) özellikleri için sayfalar oluşturmanız veya değiştirmeniz gerekecektir.

Tüm bunları sıfırdan oluşturabilirsiniz, ancak yardımcı formlar da onları oluşturmaya yardımcı olmak için mevcuttur. Doğru yaklaşım, kullandığınız diğer uzantılara bağlıdır:

Kargo ile

En iyi yol Special:CreateClass

Sayfa Formları tarafından tanımlanan Special:CreateClass sayfası, bir veri "sınıfı" hakkındaki her şeyi tek bir yerde tanımlamak için tek bir yardımcı form sağlar. Alanları doldurup "gönder" düğmesine basarsanız, sayfa otomatik olarak gerekli şablon, form ve kategori sayfalarını oluşturur. Ardından, oluşturulan form sayfasına gidip veri girmeye başlayabilirsiniz.

Tüm sayfalar oluşturuluyor gibi görünmüyorsa, iş kuyruğunuzda yeterli bellek olmayabilir. Daha fazla bellek eklemek için iş kuyruğuna ilişkin öğeye buraya bakın.

Daha kapsamlı bir yol

Aşağıdaki adımları izlemelisiniz:

  • Create templates. Bir şablon, bir sayfadaki verilerin görüntülenmesini ayarlar, verileri Kargo tablolarında depolamak için işaretlemeyi tutar ve (genellikle) sayfayı belirli bir kategoride ve dolayısıyla belirli bir sayfa türünde olarak tanımlar. Bazen her sayfa türü için bir şablon olur, ancak bazen tek bir sayfa türü birden fazla şablon içerir. Şablon, bu sayfa ile belirli bir ilişkisi olan diğer tüm sayfaların bir listesini görüntüleyerek toplama için de kullanılabilir. Special:CreateTemplate sayfasına giderek şablonları oluşturun.
  • Create forms. Artık kullanıcıların çeşitli türlerdeki sayfaları kolayca eklemesine ve düzenlemesine izin vermek için formlar oluşturabilirsiniz. Sayfa türü başına bir form olmalıdır; form, bu sayfa türünün içerdiği şablonu veya şablonları doldurur. Daha önce olduğu gibi, yeni formlar oluşturmak için özel bir sayfa var: Special:CreateForm.
  • Create categories. Her formdaki bir şablon, formun oluşturduğu her maddeyi belirli bir kategorinin parçası olarak etiketlemelidir. Bu kategorilerin her biri için bir sayfa oluşturmalı ve her maddenin onu oluşturan formla otomatik olarak düzenlenebilir olmasını sağlamak için varsayılan bir form belirtmelisiniz. Bunu yapmanın en kolay yolu Special:CreateCategory sayfasını kullanmaktır.
  • Enable links to forms. Varsayılan formu olan kategoriler oluşturmanın yanı sıra, kullanıcıların oluşturduğunuz formlara erişmesini sağlamak için atmanız gereken başka adımlar da vardır. Bunlar, kenar çubuğuna ve başka yerlere veri eklemek için bağlantılar eklemeyi ve mevcut olmayan sayfalara kırmızı bağlantıların bunları oluşturmak için bir forma işaret etmesini sağlamak için #formredlink kullanmayı içerir. Bu işlemlerin tümü "Formlara bağlantı" bölümünde açıklanmaktadır.
  • Add links on sidebar and elsewhere. Veri türlerinin her birini eklemek üzere bağlantılar tutmak için kenar çubuğunu (İngilizce dil vikileri için "MediaWiki:Sidebar" sayfasında düzenlenebilir) düzenleyebilirsiniz. Ayrıca, tüm viki verilerini bir bakışta görmenin kolay bir yolunu sağlayan Kargo tanımlı bir sayfa olan Special:Drilldown sayfasına bir bağlantı ekleyebilirsiniz. Bu bağlantıları ana sayfaya ve başka bir yere de ekleyebilirsiniz.
  • Add data. Şimdi veri girmeye başlayabilirsiniz! Form sayfalarına gidin ve sayfa oluşturmaya başlayın.
  • Customize. Yapı kurulduktan sonra, istediğiniz her şeyi özelleştirebilirsiniz. Tüm vikinin, çeşitli şablonların ve formların görünümünü ve şeklini değiştirmek, alan eklemek ve değiştirmek, sorgu eklemek ve değiştirmek.

Semantic MediaWiki ile

Kolay yolu - Special:CreateClass

Sayfa Formları tarafından tanımlanan Special:CreateClass sayfası, bir veri "sınıfı" hakkındaki her şeyi tek bir yerde tanımlamak için tek bir yardımcı form sağlar. Alanları doldurup "gönder" düğmesine basarsanız, sayfa gerekli tüm özellik, şablon, form ve kategori sayfalarını otomatik olarak oluşturur. Ardından, oluşturulan form sayfasına gidip veri girmeye başlayabilirsiniz.

Tüm sayfalar oluşturuluyor gibi görünmüyorsa, iş kuyruğunuzda yeterli bellek olmayabilir. Daha fazla bellek eklemek için iş kuyruğuna ilişkin öğeye buraya bakın.

Daha kapsamlı bir yol

Aşağıdaki adımları izlemelisiniz:

  • Create properties. Herhangi bir semantik sitenin temel yapı taşları, Semantic MediaWiki'de özellikler olarak bilinen veriler arasındaki bağlantılardır. Bir özellik, bu sayfanın konusuyla ilgili tek bir bilgi belirtmek için kullanılır. Her özellik, vikinizde "Property:" ad alanında bir sayfa olacak şekilde tanımlanmalıdır. Special:CreateProperty sayfasına giderek her özelliği oluşturun.
  • Create templates. Bir şablon, bir sayfadaki verilerin görüntülenmesini ayarlar, verileri gerçek anlamsal bilgiye dönüştürmek için işaretlemeyi tutar ve (genellikle) sayfayı belirli bir kategoride ve dolayısıyla belirli bir sayfa türünde olarak tanımlar. Bazen her sayfa türü için bir şablon olur, ancak bazen tek bir sayfa türü birden fazla şablon içerir. Bir şablon, bu sayfa ile belirli bir ilişkisi olan diğer tüm sayfaların bir listesini görüntüleyerek toplama için de kullanılabilir (bu konuda daha fazla bilgi için satır içi sorgular belgelerine bakın). Special:CreateTemplate sayfasına giderek şablonları oluşturun.
  • Create forms. Artık kullanıcıların çeşitli türlerdeki sayfaları kolayca eklemesine ve düzenlemesine izin vermek için formlar oluşturabilirsiniz. Sayfa türü başına bir form olmalıdır; form, bu sayfa türünün içerdiği şablonu veya şablonları doldurur. Daha önce olduğu gibi, yeni formlar oluşturmak için özel bir sayfa var: Special:CreateForm.
  • Create categories. Her formdaki bir şablon, formun oluşturduğu her maddeyi belirli bir kategorinin parçası olarak etiketlemelidir. Bu kategorilerin her biri için bir sayfa oluşturmalı ve her maddenin onu oluşturan formla otomatik olarak düzenlenebilir olmasını sağlamak için varsayılan bir form belirtmelisiniz. Bunu yapmanın en kolay yolu Special:CreateCategory sayfasını kullanmaktır.
  • Enable links to forms. Varsayılan formu olan kategoriler oluşturmanın yanı sıra, kullanıcıların oluşturduğunuz formlara erişmesini sağlamak için atmanız gereken başka adımlar da vardır. Bunlar, kenar çubuğuna ve başka yerlere veri eklemek için bağlantılar eklemeyi ve mevcut olmayan sayfalara kırmızı bağlantıların bunları oluşturmak için bir forma işaret etmesini sağlamak için #formredlink kullanmayı içerir. Bu işlemlerin tümü "Formlara bağlantı" bölümünde açıklanmaktadır.
  • Add links on sidebar and elsewhere. Kenar çubuğunda (İngilizce vikiler için "MediaWiki:Sidebar" sayfasında düzenlenebilir) veri türlerinin her birini ve bu veri türlerinin her birinin kategorilerini de içeren bağlantılar bulunmalıdır. Bu bağlantıları ana sayfaya ve başka bir yere de ekleyebilirsiniz.
  • Add data. Şimdi veri girmeye başlayabilirsiniz! Form sayfalarına gidin ve sayfa oluşturmaya başlayın.
  • Customize. Yapı bir kez kurulduktan sonra, istediğiniz her şeyi özelleştirebilirsiniz. Tüm vikinin, çeşitli şablonların ve formların görünümünü ve şeklini değiştirmek, alan eklemek ve değiştirmek, satır içi sorguları eklemek ve değiştirmek.

Örnek

Sayfa Formları tabanlı bir vikiyi "daha kapsamlı bir şekilde" sıfırdan oluşturmanın belirli bir örneğini inceleyelim. Evde sahip olduğunuz tüm kitapları gösteren bir viki oluşturmak istediğinizi varsayalım. Daha sonra, Kargo ve SMW için bazı bölümleri farklı olan, belirtilen önceki adımları izleyeceğiz.

1. Veri yapısını anlayın. Vikinizde iki tür sayfa istiyorsunuz: biri kitaplar, diğeri yazarlar için. Her kitap sayfasında bir başlık, yazar adı (veya adları), tür (veya türler), yayın yılı ve birkaç sayfa bulunmalıdır. Her yazar sayfasında yazarın adı, menşe ülkesi ve yazdığınız tüm kitapların bir listesi bulunmalıdır.

2. Özellik oluşturun.

Kargo ile SMW ile
Kargo için eşdeğer bir adım yoktur. Kitaplar için, kitabı temsil eden her sayfanın başlığı o kitabın başlığı olacağından başlık için bir özellik oluşturmaya gerek yoktur.

Bu dört alan bırakır:

  • Yazar(lar) - "Özellik oluştur" sayfasını (Special:CreateProperty altında) kullanarak, "Page" türünde "Was written by" adlı bir özellik oluşturursunuz (çünkü her yazarın kendi sayfası).
  • Tür - "Text" türünde "Has genre" adlı bir özellik oluşturursunuz ve buna "Sanat, Kitap, Kurgu, Tarih, Şiir, Bilim" gibi değerler verirsiniz.
  • Yayın yılı - "Number" türünde "Was published in year" adlı bir özellik oluşturursunuz.
  • Sayfa sayısı - "Number" türünde "Has number of pages" adlı bir özellik oluşturursunuz.

Yazar sayfaları için yalnızca bir özellik daha oluşturmanız gerekir:

  • Menşe ülke - "Text" türünde "Is from country" adlı bir özellik oluşturursunuz.

3. Şablon oluştur. Her ikisi de Special:CreateTemplate sayfasındaki "Şablon oluştur" sayfasında, biri kitaplar ve biri yazarlar için olmak üzere iki şablon oluşturmanız gerekir.

İlk olarak, kitaplar:

Kargo ile SMW ile
Special:CreateTemplate altında, şablon adını "Kitap" ve kategori adını "Kitaplar" olarak ayarlayın.

Buna dört alan eklersiniz ve her alan için en az üç değer belirtirsiniz: şablon kaynak kodundaki alan adı, her sayfadaki görüntü etiketi ve türü. Ayarlayabileceğiniz birkaç değer daha var, ancak bu alanların çoğu için bunlar gerekli olmayacak.

  1. İlk alan için alan adını "Yazarlar", etiketi "Yazarlar" ve türü "Page" olarak ayarlayın. Ayrıca, bu alanın bir değer listesi içerebileceğini belirten kutuyu işaretlemeniz gerekir (çünkü bir kitabın birden fazla yazarı olabilir).
  2. Alan ekle düğmesine tıklayın ve ardından ikinci alan için üç değer "Türler", "Tür(ler)" ve "String" olur. Bu alanın bir değer listesi içerebileceğini gösteren kutuyu tekrar işaretlemeniz gerekir. Ardından izin verilen değerler kümesini belirtmelisiniz; bu basit bir liste veya bir hiyerarşi olarak yapılabilir. "Sanat, Kitap, Kurgu, Tarih, Şiir, Bilim" gibi basit bir liste ayarlayabilirsiniz; veya aşağıdaki gibi görünen tam bir hiyerarşi ayarlayabilirsiniz:
* Fiction
** Science fiction
*** Cyberpunk
** Historical fiction
...ve bunun gibi.
3. Alan ekle düğmesine tıklayın ve ardından üçüncü alan için değerleri "Yıl", "Yayın yılı" ve "Tarih" ("Integer" daha iyi bir seçim) olarak ayarlayın.
4. Alan ekle düğmesine tıklayın ve ardından dördüncü alan için "Sayfa sayısı" ve "Tamsayı" olarak ayarlayın.
5. Sayfayı kaydet düğmesine tıklayın.
Special:CreateTemplate altında, şablon adını "Kitap" ve kategori adını "Kitaplar" olarak ayarlayın.

Bu alana dört alan eklersiniz ve her alan için üç değer belirtirsiniz: şablon kaynak kodundaki alan adı, her sayfadaki görüntü etiketi ve doldurduğu semantik özellik.

  1. İlk alan için alan adını "Yazarlar", etiketi "Yazar(lar)" ve semantik özelliği "Was written by" olacak şekilde ayarlayın ve bu alanın bir liste içerebileceğini belirten kutuyu işaretleyin (bir kitabın birden fazla yazarı olabileceğinden);
  2. Alan ekle düğmesine tıklayın ve ardından ikinci alan için üç değeri "Türler", "Türler" ve "Has genre" olarak ayarlayın ve ayrıca değerler listesi kutusunu işaretleyin;
  3. Alan ekle düğmesine tıklayın ve ardından üçüncü alan için değerleri "Yıl", "Yayın yılı" ve "Was published in year" olarak ayarlayın;
  4. Alan ekle düğmesine tıklayın ve ardından dördüncü alan için değerleri "Sayfa sayısı", ve "Has number of pages" olarak ayarlayın.
  5. Oluştur düğmesine tıklayın.

Ardından, Yazarlar için şablon oluşturun. "Şablon oluştur" sayfasını kullanarak, "Yazar" adlı bir şablon oluşturursunuz ve bunu "Yazarlar" kategorisini tanımlayacak şekilde ayarlarsınız.

Kargo ile SMW ile
  1. Bu şablona üç değeri "Ülke", "Menşei ülke" ve "Page" olarak ayarladığınız bir alanı eklemeniz yeterlidir.
  2. Sayfayı kaydet düğmesine tıklayın.
  1. Bu şablona, üç değeri "Ülke", "Menşe Ülke" ve "Is from country" olarak ayarladığınız bir alanı eklemeniz yeterlidir.
  2. Bu şablon için, her yazar sayfasının yazarın yazdığı tüm kitapları listelemesini istediğiniz için formdaki "Toplama" alanlarını da doldurursunuz. "Anlamsal özellik" altında, "Was written by" seçersiniz ve "Title for list" için "Books by this author" koyarsınız.
  3. Sayfayı kaydet düğmesine tıklayın.

4. Form oluşturun. Biri kitaplar ve diğeri yazarlar için olmak üzere iki form oluşturmanız gerekir:

  • Kitaplar - "Form oluştur" sayfasını (Special:CreateForm altında) kullanarak, "Kitap" adlı bir form yaparsınız, "Kitap" şablonunu seçer ve Ekle düğmesini tıklarsınız. Ayrıca isteğe bağlı olarak kitabın çizimi için bir bölüm ekleyebilirsiniz. Bunu yapmak için, "Çizim" adlı bir bölüm (şablon değil) ekleyin. Bu form üzerinde başka özelleştirmeler yapmazsınız, ancak formu oluşturduktan sonra kaydetmeniz yeterlidir.
  • Yazarlar - "Form oluştur" sayfasını kullanarak, "Yazar" adında bir form oluşturur ve buna "Yazar" şablonunu eklersiniz. Daha önce olduğu gibi, başka özelleştirmeler yapmazsınız, yalnızca sayfayı kaydedersiniz.

5. Kategori oluştur. Biri kitaplar ve diğeri yazarlar için olmak üzere iki kategori oluşturmanız gerekir; bu kategorilerin adlarını daha önce önceden belirttiniz:

  • Kitaplar - "Kategori oluştur" sayfasını (1 altında) kullanarak "Kitaplar" adlı bir kategori oluşturur ve bu sayfaya varsayılan "Kitap" biçimini verirsiniz.
  • Yazarlar - "Kategori oluştur" sayfasını kullanarak, "Yazarlar" adlı bir kategori oluşturursunuz ve bu sayfaya varsayılan "Yazar" biçimini verirsiniz.

6. Formlara olan bağlantıları etkinleştir.

Kargo ile SMW ile
Kitap şablonu metninde (Template:Book altında), ekranın etiketi içeren bölümünü bulun:
{{{Authors|}}}

Bunu aşağıdaki gibi bir şeyle değiştirin:

{{#arraymap:{{{Authors|}}}|,|x|{{#formredlink:target=x|form=Author}} }}
Kitap şablonu metni (Template:Book altında) büyük olasılıkla benzeyen bir bölüme sahiptir
{{#arraymap:{{{Authors|}}}|,|x|[[Was written by::x]]}}

Bunu aşağıdaki gibi bir şeyle değiştirin

{{#arraymap:{{{Authors|}}}|,|x|{{#formredlink:target=x|form=Author}}{{#set:Was written by=x}}}}

Bu, henüz var olmayan yazar sayfalarına bağlantılar oluşturacak ve bu sayfaları oluşturma formunu gösterecektir.

7. veri ekle. Yeni "Kitap" formunu kullanarak (Form:Book altında), bazı kitaplar için sayfalar oluşturursunuz; hem formun hem de ortaya çıkan sayfaların iyi göründüğünden emin olun. Artık her kitap sayfasının yazarına kırmızı bir bağlantısı olacak ve bu da yazarın eklenmesi için "Yazar" formuna işaret etmelidir (doğru bağlantının görünmesi için sayfayı yenilemeniz gerekebilir). Ardından, bu kurulumun da düzgün çalıştığından emin olmak için bu bağlantılar aracılığıyla veya doğrudan form sayfasından birkaç yazar ekleyebilirsiniz. Oluşturulan her yazarın sayfası, kaydettiğiniz ve yazar olarak o kişinin bulunduğu kitapların bir listesini göstermelidir.

8. Kenar çubuğuna ve başka yerlere bağlantılar ekleyin. Yapılarınız artık ayarlanmıştır ve sayfa MediaWiki:Sidebar (veya İngilizce dışında bir dil kullanıyorsanız eşdeğerini) değiştirerek kolay ekleme ve görüntüleme için kenar çubuğuna bağlantılar ekleyebilirsiniz. Yenilerini eklemeyi kolaylaştırmak için "Kitap" ve "Yazar" formlarına bağlantılar ekleyebilirsiniz. Ayrıca, kullanıcıların tüm verileri bir bakışta görmelerini sağlamak için Special:Drilldown (Kargo yüklenmişse) veya Special:BrowseData (Semantic Drilldown uzantısı yüklüyse) bağlayabilirsiniz.

Sayfa Şemalarını Kullanma

Page Schemas uzantısı özellikle formlar dahil veri yapılarının otomatik olarak oluşturulması için tasarlanmıştır. Standart PF yardımcı formlarına göre en büyük avantajı, bu veri yapısı sayfalarını sadece bir kez oluşturmakla kalmayıp, birçok kez oluşturmak ve değiştirmek için kullanılabilmesidir. Yüklü ya da Semantik MediaWiki ile ya da hiçbiri yüklü değilken kullanılabilir. Cargo ve/veya SMW yüklüyse, Page Schemas formu, gerekli ek etiketleri oluşturmak için birçok ek form alanı içerir. Bir sayfa şeması oluşturmak için, kategori sayfasına gitmeniz (henüz oluşturulmuş olsun ya da olmasın), o sayfanın şemasını oluşturmak için sekme eylemine gitmeniz, formu doldurmanız, ardından sayfaları bu şemada temel alarak oluşturmak için sekme eylemine gitmeniz gerekir. Daha fazla bilgi için Page Schemas belgelerine bakın.

Hızlı kaynak kılavuzları

Diğer uzantıların yanı sıra Sayfa Formları hakkında faydalı bilgiler içeren (her iki durumda da buna "Semantic Forms" olarak atıfta bulunsalar da), yazdırmaya uygun iki hızlı başvuru kılavuzu veya "kısa notlar" vardır:

  • Cargo hızlı kaynak kılavuzu - PNG ve PDF biçimlerinde
  • Semantic MediaWiki hızlı kaynak kılavuzu - burada, PNG (resim), PDF ve SVG biçimlerinde bulunabilir