README-tr.asc

Asciidoc Book Editor based on JavaFX 8

AsciidocFX bir kitap / doküman editörü olup, HTML, PDF, Epub ya da Mobi e-kitaplar oluşturmayı sağlar.

Figure 1. AsciidocFX

Table of Contents

• Özellikler
• AsciidocFX Nasıl Yüklenir
  • Kurulma Notları
• Hızlı Bir Başlangıç
• PlantUML Eklentisi
• MathJax Eklentisi
• Tex Çıktısı
• MathML Çıktısı
• Filesystem Tree Eklentisi
• Filesystem Tree Çıktısı
• Filesystem Tree Çıktısı
• JavaFX Charts Eklentisi (yeni)
  • Pie Diyagramı
  • Area Diyagramı
• AsciidocFX Nasıl Derlenir
• AsciidocFX ile Yazılan Kitaplar
• Kullanılan Teknolojiler
• AsciidocFX Yapılandırması
• Bazı Kısayollar
• Bilinen Sorunlar
• Günlük
• Destek

Özellikler

• Gerçek Zamanlı Önizleme

• Çoklu Platform Seçeneği (Windows, Mac, Linux ..)

• Asciidoc Kitapları Oluşturma

• Markdown Kitapları Oluşturma

• PDF, HTML, Epub, Mobi ve Docbook Oluşturma

• Epub Görüntüleme

• Harici Tarayıcı Desteği

• Tablo Oluşturucu

• MathJax Eklentisi

• PlantUML Eklentisi

• Filesystem Tree Eklentisi

• JavaFX Charts Eklentisi

AsciidocFX Nasıl Yüklenir

Github releases sayfasından son yayınlanan halini indirebilisiniz.

Ayrıca, Arch Linux’de paket yöneticisi yoluyla da yükleyebilirsiniz.

$ yaourt -S asciidocfx

Kurulma Notları

Her bir yayım başka bir efora gerek duymadan JRE 8 içermektedir. Şayet, JRE 8 (Güncelleme 40 ve üzeri) 'i yüklemişseniz, *No_JRE builds olanları indirebilirsiniz.

PlantUML eklentisi Graphviz (Graph Visualization Software) istemektedir, eğer bu eklentiyi kullanmak iserseniz, bu yazılımı indirip yüklemeniz gerekmektedir.

Ayrıca, Microsoft Core Fonts, Linux OSes sistem üzerinde yüklenmelidir.

Linux/Ubuntu/Debian

Graphviz ve Microsoft Core Fonts bağımlılıkları:

sudo apt-get install graphviz ttf-mscorefonts-installer

Mac OS X

Graphviz bağımlılığı:

ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
brew install graphviz

Windows

Graphviz bağımlılığı:

http://www.graphviz.org/pub/graphviz/stable/windows/graphviz-2.38.msi

Hızlı Bir Başlangıç

Video - AsciidocFX ile Kitap Yazma

PlantUML Eklentisi

UML ihtiyaclarınızı AsciidocFX ile gerçekleştirebilirsiniz. AFX PlantUML desteği sunmaktadır. AFX, metinsel UML elemenlerini PNG ve SVG resim formatına kolaylıkla dönüştürmektedir.

PlantUML rahatlıkla aşağıdaki diyagramları oluşturmanıza izin veren bir bileşendir :

• Sequence diagram,

• Usecase diagram,

• Class diagram,

• Activity diagram, (here is the new syntax),

• Component diagram,

• State diagram,

• Object diagram.

• wireframe graphical interface

.UML Diyagram Örneği
[uml,file="uml-example.png"]
--
abstract class AbstractList
abstract AbstractCollection
interface List
interface Collection

List <|-- AbstractList
Collection <|-- AbstractCollection

Collection <|- List
AbstractCollection <|- AbstractList
AbstractList <|-- ArrayList

class ArrayList {
  Object[] elementData
  size()
}

enum TimeUnit {
  DAYS
  HOURS
  MINUTES
}

annotation SuppressWarnings
--

Figure 2. UML çıktı örneği

Note	Bazı UML elementlerinde PlantUML, Graphviz ile çalışması gerekmektedir. Bu yüzden, kendi platformunuza bu yazılımı manüel olarak yüklemelisiniz. Graphviz’in yüklenmesinden sonra, GRAPHVIZ_DOT ortam değişkenini dot çalıştırılabilir olarak Graphviz içinde ayarlamalısınız.

MathJax Eklentisi

MathJax, her tarayıcıda matematiksel ifadeler için çalışan açık kaynaklı JavaScript görüntü motorudur.

AsciidocFX’de Tex ve MathML dillerini matematiksel formülleri tanımlamak için kullanabilirsiniz. AsciidocFX yazılan metinsel formülleri PNG ya da SVG formatına dönüştürür.

Örneğin (Tex)

[math,file="tex-formula.png"]
--
\begin{align}
\dot{x} & = \sigma(y-x) \\
\dot{y} & = \rho x - y - xz \\
\dot{z} & = -\beta z + xyp
\end{align}
--

Tex Çıktısı

Örneğin (MathML)

[math,file="mathml-formula.png"]
--
<math xmlns="http://www.w3.org/1998/Math/MathML" display="block">
  <mi>x</mi>
  <mo>=</mo>
  <mrow>
    <mfrac>
      <mrow>
        <mo>&#x2212;</mo>
        <mi>b</mi>
        <mo>&#xB1;</mo>
        <msqrt>
          <msup>
            <mi>b</mi>
            <mn>2</mn>
          </msup>
          <mo>&#x2212;</mo>
          <mn>4</mn>
          <mi>a</mi>
          <mi>c</mi>
        </msqrt>
      </mrow>
      <mrow>
        <mn>2</mn>
        <mi>a</mi>
      </mrow>
    </mfrac>
  </mrow>
  <mtext>.</mtext>
</math>
--

MathML Çıktısı

Important

Internet bağlantısı gerektirmektedir! AsciidocFX MathJax bağımlılıklarını CDN’den çekmektedir.

Filesystem Tree Eklentisi

Belirtilen tree bloğunda dosya sisteminizi yansıtabilirsiniz. FS ağacının iki biçimi vardır.

[tree,file="tree-view.png"]
--
#src
##main
###java
####com
#####kodcu
######App.java
###resources
####css
#####style.css
####js
#####script.js
####images
#####image.png
--

Filesystem Tree Çıktısı

[tree,file="tree-view-new.png"]
--
root
|-- photos
|   |-- camp.gif
|   |-- festival.png
|   `-- balloon.jpg
|-- videos
|   |-- car-video.avi
|   |-- dance.mp4
|   |-- dance01.mpg
|   |-- another video.divx
|   `-- school videos
|       `-- firstday.flv
|-- documents
|   |-- jsfile.js
|   |-- powerpoint.ppt
|   |-- chapter-01.asc
|   |-- archive-db.zip
|   |-- .gitignore
|   |-- README
|   `-- configuration.conf
`-- etc.
--

Filesystem Tree Çıktısı

JavaFX Charts Eklentisi (yeni)

JavaFX 8 çeşit Diyagram/Tablo bileşenine sahiptir. AsciidocFX bunların hepsini desteklemektedir.

Pie Diyagramı

[chart,pie,file="secim-2014-pie.png",opt="title=2014 YEREL SEÇİM SONUÇLARI"]
--
AKP,  45.6, orange
CHP,  27.8,red
MHP,  15.2
BDP,  4.2
SP,  2
--

---

chart::pie[data-uri="pie.csv",file="secim-2014-pie-csv.png"]

Area Diyagramı

[chart,area,file="area-chart.png"]
--
//April
1,  4
3,  10
6,  15
9,  8
12, 5

//May
1,  20
3,  15
6,  13
9,  12
12, 14
--

---

chart::area[data-uri="area.csv",file="area-chart-csv.png"]

Diğer mevcut seçenekler ve diyagramlar için, lütfen Chart Eklentisi wiki sayfasına göz atın!

AsciidocFX Nasıl Derlenir

1. İlk olarak, JDK 8'i yükleyin.

2. Apache Maven'ı indirin ve /bin dizinini ortam değişkeni olarak ayarlayın.

3. AsciidocFX dizinine girin ve $ mvn clean install komutunu çalıştırın.

4. target/appassembler/bin dizin yolunu izleyin ve sonunda asciidocfx.sh ve asciidocfx.bat dosyalarının oluştuğunu göreceksiniz.

Note	Travis-CI yardımıyla derlemeleri otomatik olarak oluşturmaktayız.

Note	Tüm derlemeler x64 dayalıdır. Eğer x86 sistemlerde kullanmak istiyorsanız, AsciidocFX’i kendiniz derlemeniz gerekecektir.

AsciidocFX ile Yazılan Kitaplar

Java 8 Ebook

• Github

• ePub + Kindle + PDF

AspectJ Ebook

• Github

• ePub + Kindle + PDF

Kullanılan Teknolojiler

AsciidocFX, Java, JavaScript ve XML bağlantılı teknolojileri kullanmaktadır.

• Java FX 8

• Asciidoctor.js

• Spring Boot

• Spring WebSocket

• Docbook

• Apache Fop

• Saxon 6.5

• Ace editor

AsciidocFX Yapılandırması

/conf dizininde bulunan config.yml dosyası ile AsciidocFX’i konfigüre edebilirsiniz.

Ace temasını, yazı boyutunu, yazı tipini ve diğer bölümleri dosyayı düzenleyerek değiştirebilirsiniz.

Bazı Kısayollar

AsciidocFX bazı özel kısayollara sahiptir. Eğer başka kısayol isteği önerirseniz, geliştirebiliriz.

Kısayol	Detay
Ctrl+V	Seçim dönüştürür ve yapıştırır
Ctrl+Shift+V	Seçim yapıştırır
tblx,y+Tab	Asciidoc tablosu oluşturur (x=satır,y=sütun)
tblx.y+Tab	Asciidoc table oluşturur (x=satır,y=sütun)
src+Tab	Asciidoc kaynak kod bloğu oluşturur (Varsayılan dil: java)
src.lang+Tab	Asciidoc kaynak kod bloğu oluşturur "lang" tarafından
src,lang+Tab	Asciidoc kaynak kod bloğu oluşturur "lang" tarafından
img+Tab	Resim bloğu oluşturur
book+Tab	Kitap başlığı bölümü oluşturur
article+Tab	Makale başlığı bölümü oluşturur
uml+Tab	UML blok oluşturur
math+Tab	Math blok oluşturur
tree+Tab	Tree blok oluşturur
quote+Tab	Quote blok oluşturur
Ctrl+B	Seçimi kalın (bold) yapar
Ctrl+I	Seçimi eğik (italic) yapar
Ctrl+U	Seçimin altını çizer (underline)
Ctrl+H	Seçimi vurgulu yapar (highlight)
Ctrl+D	Seçimin kopyasını yapar
Ctrl+L	Satır numaralarını gösterir
Ctrl+X	Mevcut satırı siler
Ctrl+N	Yeni bir doküman yaratır
Ctrl+M	Tab panelini maximum hale getirir
Ctrl+S	Mevcut dokümanı kaydeder
Ctrl+W	Mevcut dokümanı kaydedip kapatır.
Ctrl+Shift+C	Seçimi (backtick) `` ile çevreler
Ctrl+Mouse_Scroll_Up	Yakınlaştırır
Ctrl+Mouse_Scroll_Down	Uzaklaştırır
F12	Firebug Lite bölümünü açar (Internet bağlantısı gerektirir)

Bilinen Sorunlar

JavaFX tüm klavyelere "QWERTY" olarak davranıyor. Bu sebeple Alman klavyesinde CTRL-Z ve CTRL-Y ters olarak çalışmaktadır.

Günlük

AsciidocFX versiyonlarındaki son değişiklikleri görmek için lütfen CHANGELOG dosyasına göz atın!

Destek

Hata, öneri ve yeni özellik istekleriniz için PR (pull requests) ya da bir konu açarak AsciidocFX’e desteğinizi verebilirsiniz. Mail Grubumuzda isteklerinizi bir konu içerisinde anlatabilirsiniz ya da Gitter.im 'de mevcut sohbet kanalımızda fikirlerinizi bizlere iletebilirsiniz.