Text Formatlama¶

• Table of contents
• Text Formatlama
  • Linkler
    • Redmine linkleri
    • Dış linkler
    • Email adresleri
  • Text formatlama
    • Kısaltma
    • Font stili
    • Renk
    • Satıriçi resimler
    • Başlıklar
    • Pragraflarlar
    • Yatay Çizgi
    • Ön Tanımlılar
    • Blok alıntılar
    • Sırasız listeler
    • Sıralı listeler
    • Tablolar
    • İçindekiler Bölümü
  • Makrolar
  • Kod renklendirme
  • Textile formatlama
  • Çeviri

Linkler¶

Redmine linkleri¶

Redmine text formatlamanın kullanıldığı her yerde kaynaklar arasında (işler, changesetler, wiki sayfaları...) linkler oluşturmanıza izin verir.

• İşe link: #124 (#124 nolu işi gösterir, eğer iş kapatılmışsa üzeri çizgili olarak gösterilir)
• İşe ait bir nota link: #124-6, veya #124!#note-6
• Changesete link: r758 (r758 changesetini gösterir)
• Nümerik olmayan hashli changesete link: commit:c6f4d0fd (c6f4d0fd changesetini gösterir).

Wiki linkleri:

• [[Guide]] 'Guide' isimli sayfaya bir link oluşturur: Guide
• [[Guide|User manual]] aynı sayfaya farklı bir isimle bir link oluşturur: User manual
• [[Guide#User-guide|User guide]] aynı sayfadaki başlığa başka bir isimle link oluşturur: User guide

Başka bir projeye ait wiki sayfalarına da linkler oluşturabilirsiniz (proje anahtarını kullanarak)

• [[sandbox:some page]] Sandbox projesindeki 'Some page' sayfasına bir link oluşturur
• [[sandbox:]] Sandbox projesinin Wiki anasayfasına bir link oluşturur

Wiki linkleri henüz böyle bir sayfa yoksa kırmızı olarak gösterilir, örn: Nonexistent page.

Diğer kaynaklara linkler:

• Dökümanlar:
  • document#17 (idsi 17 olan dökümana link)
  • document:Greetings (başlığı "Greetings" olan dökümana link)
  • document:"Some document" (başlıkta boşluk varsa " kullanarak yazabilirsiniz)
  • sandbox:document:"Some document" ( Sandbox projesindeki "Some Document" başlıklı dökümana bir link)

• Versiyonlar:
  • version#3 (idsi 3 olan versiyona bir link)
  • version:1.0.0 (adı "1.0.0" olan versiyona bir link)
  • version:"1.0 beta 2" (versiyon adında boşluk varsa " kullanabilirsiniz)
  • sandbox:version:1.0.0 (Sandbox projesindeki "1.0.0" isimli versiyona link)

• Eklentiler:
  • attachment:file.zip (mevcut nesnedeki file.zip eklentisine link)
  • attachment:"file.zip" (dosya adı boşluk içeriyorsa " kullanabilirsiniz)
  • Şimdilik sadece mevcut nesnedeki eklentilere referans verebilirsiniz. (Eğer bir işte iseniz, sadece o işe ait eklentilere linkler yaratabilirsiniz)

• Changesetler:
  • r758 (Changesete link)
  • commit:c6f4d0fd (nümerik olmayan hashli changesete link)
  • svn1|r758 (Çok kaynak kodu depolu projelerde belirli bir kaynak kodu deposuna ait changesete link)
  • commit:hg|c6f4d0fd (belirli bir kaynak kodu deposuna ait nümerik olmayan hashli changesete link)
  • sandbox:r758 (başka bir projede bulunan bir changesete link)
  • sandbox:commit:c6f4d0fd (başka bir projede bulunan nümerik olmayan hashli bir changesete link)

• Kaynak Kodu Deposu dosyaları:
  • source:some/file -- proje kaynak deposundaki /some/file klasöründe bulundan bir dosyaya link
  • source:some/file@52 -- dosyanın 52 numaralı versiyonuna link
  • source:some/file#L120 -- dosyanın 120.ci satırına link
  • source:some/file@52#L120 -- dosyanın 52 numaralı versiyonun 120.ci satırına link
  • source:"some file@52#L120" -- URL boşluk içeriyorsa " kullanabilirsiniz
  • source:repo_identifier|some/file -- projenin varsayılan kaynak deposu dışındaki bir kaynak deposunda bulunan bir dosyaya link
  • source:"repo_identifier|some file" -- projenin varsayılan kaynak deposu dışındaki bir kaynak deposunda bulunan, dosya yolunda boşluk bulunan bir dosyaya link
  • export:some/file -- Dosyayı indirmeye zorla

• Forumlar:
  • forum#2 (idsi 2 olan foruma link)
  • forum:Discussion ("Discussion" başlıklı foruma link)
  • forum:"Help and more" (başlıkta boşluk varsa " kullanabilirsiniz)

• Forum mesajları:
  • message#1218 (idsi 1218 olan mesaja link)

• Haberler
  • news#1 (idsi 1 olan habere link)
  • news:Greetings ("Greetings" başlıklı habere link)
  • news:"eCookbook first release !" (başlıkta boşluk varsa " kullanabilirsiniz)

• Projeler:
  • project#3 (idsi 3 olan projeye link)
  • project:someproject ("someproject" adlı projeye link)
  • project:"Multiple words project" (proje adında boşluk varsa " kullanabilirsiniz)

Engelleme:

• Redmine linklerinin oluşmasını başlarına ünlem işareti koyarak engelleyebilirsiniz: !

Dış linkler¶

HTTP URL ler otomatik olarak tıklanabilir linklere dönüştürülür:

• http://www.redmine.org -- Redmine web sitesine link: http://www.redmine.org
• someone@foo.bar -- Bir email adresine link: someone@foo.bar

HTTP URL ler de kendi metinleri dışında bir metin kullanabilirler:

• "Redmine web sitesi":http://www.redmine.org -- Başka bir metinle yaratılmış dış link: Redmine web site
• !http://www.redmine.org/attachments/7069/Redmine_logo.png(Redmine web sitesi)!:http://www.redmine.org -- Dışarıdan alınan bir imajla yaratılmış bir dış link:

Email adresleri¶

Email adresleri otomatik olarak tıklanabilir linklere dönüştürülür:

• "Birine Email Gönder":mailto:someone@foo.bar -- Birine başka bir textle email gönderen linki oluştur: Email someone

Email linklerine daha karmaşık talimatlar da uygulanabilir. Varsayılan başlık, varsayılan email metni ve CC bilgisi tanımlanabilir. Bütün bu alanlarda yer alan tüm boşluklar %20 ile değiştirilmelidir.

• "Email webmaster and admin":mailto:webmaster@foo.bar?cc=admin@foo.bar -- Webmastera normal email, admine cc email oluşturan link : Email webmaster and admin
• "Email someone for help":mailto:someone@foo.bar?subject=Website%20Help -- "Website Help" başlıklı bir email oluşturan link: Email someone for help
• "Email someone for help":mailto:someone@foo.bar?subject=Website%20Help&body=My%20problem%20is%20 -- "Website Help" başlıklı bir email oluşturan ve varsayılan metni bulunan bir email oluşturan link: Email someone for help

Text formatlama¶

Başlıklar, kalın metinler, tablolar, listeler gibi şeyler için Redmine "Textile" text yorumlama kütüphanesini destekler. http://en.wikipedia.org/wiki/Textile_%28markup_language%29. Bu özelliklerle ilgili bilgi için http://redcloth.org/hobix.com/textile/ adresini ziyaret edebilirsiniz. Aşağıda bir kaç örnek bulabilirsiniz fakat kütüphaneyi kullanarak çok daha fazla şeyler yapabilirsiniz.

Kısaltma¶

JPL(Jean-Philippe Lang)

Görünümü:

JPL

Font stili¶

* *kalın*
* _italik_
* *_kalın italik_*
* +altı çizili+
* -üstü-çizili-
* Düz ^üstyazı^
* Düz ~altyazı~
* @inline monospace@
* normal *kalın* _italik_ normal;E=mc ^2^
* normal<notextile></notextile>*kalın*<notextile></notextile>_italik_<notextile></notextile>normal;E=mc<notextile></notextile>^2^
* Engelleme: <notextile>*kalın* _italik_ @inlinemono@</notextile> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp; HTML alternatif: &#42;kalın&#42; &#95;italik&#95; &#64;inlinemono&#64;
* <pre>*some lines*      some "link":http://www.redmine.org</pre>
* <pre><notextile></notextile>*some lines*      some "link":http://www.redmine.org</pre>

Görünümü:

• kalın
• italik
• kalın italik
• underline
• strike-through
• Plain ^superscript
• Plain _subscript
• inline monospace
• normal kalın italik normal;E=mc ²
• normalkalınitaliknormal;E=mc²
• Escaping: *kalın* _italik_ @inlinemono@       Alternative using HTML-codes: *kalın* _italik_ @inlinemono@

• *some lines*      some "link":http://www.redmine.org

• some lines      some link

Renk¶

* %{color:red}kırmızı% %{color:green}yeşil% %{color:yellow}sarı% %{color:#82B6E1}mavimsi%
* %{color:red}kırmızı%<notextile></notextile>%{color:green}yeşil%<notextile></notextile>%{color:yellow}sarı%<notextile></notextile>%{color:#82B6E1}mavimsi%
* %{background:lightgreen}Açık yeşil arkaplan% %{background:yellow}Sarı arkaplan%
* %{background:lightgreen}Açık yeşil arkaplan%<notextile></notextile>%{background:yellow}Sarı arkaplan%

Görünümü:

• kırmızı yeşil sarı mavimsi
• kırmızıyeşilsarımavimsi
• Açık yeşil arkaplan Sarı arkaplan
• Açık yeşil arkaplanSarı arkaplan

Satıriçi resimler¶

• !image_url! image_url adresinde bulunan bir resim (textile syntax)
• !>image_url! sağa yaslanmış resim
• !image_url(Image title)! alt/title özellikli bir resim
• !image_url!:URL image_url adresinde bulunan link url li bir resim

Wiki sayfanızda resim eklentisi bulunuyorsa dosya adı ile gösterilebilir: !attached_image.png!

SPAN elementlerindeki benzer olarak resimlere de CSS stilleri uygulanabilir. !{width: 100%}attached_image.png! kod parçacağı resimin bir üstündeki elementin boyutuna göre boyutlanmasını sağlayacaktır.

Başlıklar¶

h1. Başlık

h2. AltBaşlık

h3. AltBaşlık

Redmine istediğiniz zaman "#Başlık", "#AltBaşlık" şeklindeki başlıklara dönebilmeniz için linkler oluşturur.

Pragraflarlar¶

p. sola yaslanmış

  p(. soldan 1em içeride

    p((. soldan 2em içeride
    ve aşağıdaki satırlar

                                                                                   p>. sağa yaslanmış

                                                                        p)))>. sağdan 3em içeride

                           p=. Ortalanmış paragraf.

Yatay Çizgi¶

----
Görünümü:

---

Ön Tanımlılar¶

Wiki formatlamayı engellemek için

 <pre> *Yazınız kalın olmayacak* </pre> 

Görünümü:

 *Yazınız kalın olmayacak* 

Blok alıntılar¶

Paragrafa bq. ile başlayın:

bq. Rails is a full-stack framework for developing database-backed web applications according to the Model-View-Control pattern.
To go live, all you need to add is a database and a web server.

Görünümü:

Rails is a full-stack framework for developing database-backed web applications according to the Model-View-Control pattern.
To go live, all you need to add is a database and a web server.

Aynı zamanda her satır başında > kullanabilir ve içiçe alıntılar oluşturabilirsiniz:

>> Rails is a full-stack framework for developing database-backed web applications according to the Model-View-Control pattern.
>> To go live, all you need to add is a database and a web server.
> Great!

Görünümü:

Rails is a full-stack framework for developing database-backed web applications according to the Model-View-Control pattern.
To go live, all you need to add is a database and a web server.

Great!

Sırasız listeler¶

* Item 1
* Item 2
** Item 21
** Item 22
* Item 3

Görünümü:

• Item 1
• Item 2
  • Item 21
  • Item 22
• Item 3

Sıralı listeler¶

# Item 1
# Item 2
# Item 3
## Item 3.1
## Item 3.2

Görünümü:

1. Item 1
2. Item 2
3. Item 3
   1. Item 3.1
   2. Item 3.2

Tablolar¶

|_.UserID      |_.Name          |_.Group     |_. attribute list   |
|Basit           | bir            |   satırla  |başlayalım                 |
|\3=.IT                                      |<. sola yasla       |
|1             |Artur Pirozhkov |/2.Users    |>. sağa yasla      |
|2             |Vasya Rogov     |=. ortala   |
|3             |John Smith      |Admin
                                 (root)      |^. yukarı yasla       |
|4             |-               |Nobody
                                 (anonymous) |~. aşağı yasla    |

Görünümü (birden fazla boşluk bıraktığınızda tek bir boşlukla değiştirilir):

UserID	Name	Group	attribute list
Basit	bir	satırla	başlayalım
IT			sola yasla
1	Artur Pirozhkov	Users	sağa yasla
2	Vasya Rogov		ortala
3	John Smith	Admin (root)	yukarı yasla
4	-	Nobody (anonymous)	aşağı yasla

Tablonuzda | karakterini kullanmak istiyorsanız (örn. Wiki linkleri için), textile yorumlamasını engellemelisiniz:

Input	Output
<notextile>|</notextile>	|

İçindekiler Bölümü¶

{{toc}} => sola yaslanmış içindekiler
{{>toc}} => sağa yaslanmış içindekiler

"toc" nin bir satır öncesinin ve bir satır sonrasının boş satırlar olması gerektiğini, ve yanında başka bir metin bulunmaması gerektiğini unutmayınız.

Örn:

h1. headLineOne

h2. something

{{toc}}

h2. something more

Makrolar¶

Redmine formatlanmış metin içerisine dinamik olarak içerik eklemenizi sağlayan bir makro sistemi bulundurur. Kendi makrolarınızı yazmak için detaylı bilgi için RedmineMacros. Redmine içinde aynı zamanda önceden tanımlanmış makrolar da bulunmaktadır:

hello_world

Sample macro.

macro_list

Displays a list of all available macros, including description if available.

child_pages

Displays a list of child pages. With no argument, it displays the child pages of the current wiki page. Examples:

{{child_pages}} -- can be used from a wiki page only
{{child_pages(depth=2)}} -- display 2 levels nesting only
{{child_pages(Foo)}} -- lists all children of page Foo
{{child_pages(Foo, parent=1)}} -- same as above with a link to page Foo

include

Includes a wiki page. Examples:

{{include(Foo)}}
{{include(projectname:Foo)}} -- to include a page of a specific project wiki

collapse

Inserts of collapsed block of text. Examples:

{{collapse
This is a block of text that is collapsed by default.
It can be expanded by clicking a link.
}}

{{collapse(View details...)
With custom link text.
}}

thumbnail

Displays a clickable thumbnail of an attached image.
Default size is 200 pixels. Examples:

{{thumbnail(image.png)}}
{{thumbnail(image.png, size=300, title=Thumbnail)}} -- with custom title and size

issue

Displays an issue link including additional information. Examples:

{{issue(123)}}                              -- Issue #123: Enhance macro capabilities
{{issue(123, project=true)}}                -- Andromeda - Issue #123: Enhance macro capabilities
{{issue(123, tracker=false)}}               -- #123: Enhance macro capabilities
{{issue(123, subject=false, project=true)}} -- Andromeda - Issue #123

sample_macro

Sample macro

Kod renklendirme¶

Kod renklendirme CodeRay, adında tamamen Ruby ile yazılmış kod renklendirme kütüphanesi ile yapılmaktadır. . Şu anda desteklediği diller: C, C++, CSS, Delphi, Diff, Groovy, HTML, Java, Javascript, JSON, Nitro-XHTML, PHP, Python, RHTML, Ruby, Scheme, SQL, XML ve YAML.

Aşağıdaki şekilde wiki sayfalarında kodunuzu renklendirebilirsiniz:

<pre><code class="ruby">
  Place your code here.
</code></pre>

Örnek:

# The Greeter class
class Greeter
  def initialize(name)
    @name = name.capitalize
  end

  def salute
    puts "Hello #{@name}!" 
  end
end

Textile formatlama¶

Redmine textile formatlama kütüphanesini desteklemektedir. Detaylar için Textile syntax

Diğer desteklenen textile yorumlama tagları:

• %{background:lightgreen}Yeşil arkaplan% displays Yeşil arkaplan

Çeviri¶

Çevirilerin güncel olmayabileceğini hatırlatırız. Gerekli durumlarda lütfen ingilizce dokümantasyona başvurunuz.

• Русский
• French
• Korean
• Türkçe

Bu döküman Mustafa Ergin tarafından hazırlanmıştır.