hoverkraf - Dalam talian di Awan

JADUAL:

NAMA

hoverkraf - hoverkraf! Dokumentasi

Kandungan:

PENGENALAN

GUI alat adalah mengehadkan
Saya pernah melakukan pembentangan dengan perisian tayangan slaid biasa, seperti OpenOffice/LibreOffice
Kagum, tetapi alat ini terasa terhad dan terhad. Saya perlu melakukan banyak penyusunan semula
dan bergerak, dan ini mungkin bermakna menukar perkara daripada senarai peluru kepada tajuk ke
teks kepada gambar dan kembali ke senarai bullet sekali lagi. Ini berlaku melalui keseluruhan
proses. Saya mungkin menyedari sesuatu yang hanya titik peluru perlu menjadi slaid, atau
bahawa satu set slaid atas sebab masa perlu dipendekkan kepada titik peluru. Banyak
penyusunan semula datang daripada melihat apa yang sesuai pada satu slaid dan apa yang tidak, dan bagaimana saya
perlu mempercepatkan pembentangan, dan sedikit sebanyak apa jenis gambar yang saya dapati
untuk menggambarkan apa yang saya cuba katakan, dan jika gambar itu lucu atau tidak.

Penyampaian perisian Sekiranya memberi anda melengkapkan kebebasan kepada menyusun semula Matlamat persembahan on
setiap tahap, tidak hanyalah by menyusun semula slaid.

Penyelesaian untuk saya dan ramai lagi, adalah menggunakan bahasa penanda teks, seperti
reStructuredText, Markdown atau serupa, dan kemudian gunakan alat yang menjana slaid HTML
menunjukkan daripada itu.

Penanda teks memberikan anda yang kemudahan and kebebasan kepada cepat bergerak bahagian sekitar as anda
seperti.

saya telah memilih reStructuredText, kerana saya tahu dan kerana ia mempunyai set ciri yang besar. Bila
Saya membaca dokumentasi bahasa penanda teks lain tidak jelas jika mereka mempunyai
ciri yang saya perlukan atau tidak.

Kuali, berputar and zum
Alat yang wujud untuk membuat persembahan daripada text-markup akan membuat tayangan slaid yang mempunyai
urutan slaid dari kiri ke kanan. Tetapi fesyen sekarang adalah untuk mengadakan persembahan itu
berputar dan zon masuk dan keluar. Satu penyelesaian sumber terbuka untuk itu ialah impress.js.

Dengan impress.js anda boleh membuat moden sejuk pembentangan.

Tetapi impress.js memerlukan anda menulis pembentangan anda sebagai HTML, yang menjengkelkan, dan
markup tidak cukup fleksibel untuk membolehkan anda menyusun semula perkara dengan cepat daripada titik tumpu kepada
tajuk dsb.

Anda juga perlu meletakkan setiap slaid secara berasingan, dan jika anda memasukkan slaid baru dalam
tengah, anda perlu meletakkan semula semua slaid yang mengikuti.

Hoverkraf!
Jadi apa yang saya mahukan ialah alat yang mengambil kuasa, fleksibiliti dan kemudahan
reStructuredText dan membolehkan saya menjana kuali, putar dan zum pembentangan dengan
impress.js, tanpa perlu meletakkan semula setiap slaid secara manual jika saya menyusun semula sedikit
daripada pembentangan. Saya tidak dapat mencari satu, jadi saya membuat Hovercraft.

Kuasa Hovercraft datang daripada gabungan kemudahan reStructuredText dengan
keren daripada impress.js, bersama-sama dengan penyelesaian yang fleksibel dan berkuasa untuk meletakkan slaid.

Terdapat empat cara untuk meletakkan slaid:

1. Kedudukan mutlak: Anda hanya menambah koordinat X dan Y pada slaid, dalam piksel.
Melakukan ini sahaja tidak akan menyeronokkan, tetapi seseorang mungkin memerlukannya.

2. Kedudukan relatif: Dengan menyatakan x dan/atau y dengan r permulaan, anda tentukan
jarak dari slaid sebelumnya. Dengan menggunakan bentuk kedudukan ini anda boleh
masukkan slaid, dan slaid lain hanya akan bergerak untuk memberi ruang untuk slaid baharu.

3. Secara automatik: Jika anda tidak menyatakan sebarang kedudukan, slaid akan berakhir dengan sama
jarak dari slaid sebelumnya kerana slaid sebelumnya adalah dari slaid sebelumnya.
Ini lalai untuk mengalihkan 1600px ke kanan, yang bermaksud bahawa jika anda membekalkan no
kedudukan di mana-mana sahaja dalam pembentangan, anda mendapat standard membosankan
persembahan slaid ke kiri.

4. Dengan laluan SVG: Dengan cara penentududukan terakhir ini, anda boleh mengambil laluan SVG daripada
Dokumen SVG dan lekatkannya ke dalam pembentangan, dan slaid itu + semua slaid
mengikuti yang tidak mempunyai kedudukan yang jelas akan diletakkan pada laluan itu. Ini boleh
menjadi agak licik untuk digunakan, tetapi boleh mencipta hasil yang hebat, seperti meletakkan kedudukan
slaid sebagai Python snaking atau serupa.

Hoverkraf! juga termasuk impress-console, konsol penyampai yang akan menunjukkan kepada anda
nota, pratonton slaid dan masa, alatan penting untuk sebarang pembentangan.

MENGGUNAKAN HOVERCRAFT!

Anda boleh menggunakan Hovercraft! untuk menjana persembahan sebagai HTML dalam direktori sasaran,
atau anda boleh membiarkan Hovercraft! menyajikan persembahan daripada pelayan web terbinanya.

Yang terakhir mempunyai beberapa faedah. Salah satunya ialah kebanyakan penyemak imbas web akan sangat keberatan
buka tetingkap pop timbul daripada halaman yang disampaikan daripada sistem fail ini adalah langkah keselamatan yang
boleh diubah, tetapi lebih mudah untuk hanya menghalakan penyemak imbas ke http://localhost: 8000
sebaliknya.

Faedah kedua ialah Hovercraft! akan memantau fail sumber untuk pembentangan,
dan jika ia diubah suai Hovercraft! akan menjana persembahan semula secara automatik.
Dengan cara itu anda tidak perlu menjalankan Hovercraft! setiap kali anda menyimpan fail, anda hanya perlu
muat semula penyemak imbas.

Parameter
hoverkraf [-h] [-t TEMPLAT] [-c CSS] [-a] [-s] [-n] [-hlm PELABUHAN]
[ ]

Hujah kedudukan:


Laluan ke fail pembentangan reStructuredText.


Direktori tempat persembahan disimpan. Akan dibuat jika tidak
wujud. Jika anda tidak menyatakan targetdir Hovercraft! sebaliknya akan memulakan a
pelayan web dan menyampaikan persembahan daripada pelayan itu.

Hujah pilihan:

-h, - membantu
Tunjukkan bantuan ini.

-t TEMPLAT, --template TEMPLAT
Tentukan templat. Mestilah fail .cfg, atau direktori dengan a template.cfg
fail. Jika tidak diberikan ia akan menggunakan templat lalai.

-c css, --css CSS
Fail CSS tambahan untuk digunakan oleh pembentangan. Lihat juga :css: tetapan
daripada pembentangan.

-A, --auto-konsol
Buka konsol penyampai secara automatik. Ini berguna semasa anda berlatih
dan memastikan nota pembentang adalah betul. Anda juga boleh menetapkan ini dengan
mempunyai :auto-konsol: benar pertama dalam pembentangan.

-ya, --langkau-bantuan
Jangan tunjukkan pop timbul bantuan awal.

-n, --langkau-nota
Jangan sertakan nota pembentang dalam output.

-p PELABUHAN, --pelabuhan PORT
Alamat dan port yang digunakan oleh pelayan. Ex 8080 atau 127.0.0.1:9000. Lalai
kepada 0.0.0.0:8000.

Dibina in template
Terdapat dua templat yang disertakan dengan Hovercraft! Satu dipanggil lalai dan akan digunakan
melainkan anda menentukan templat. Ini adalah templat yang anda akan gunakan pada kebanyakan masa.

Yang kedua dipanggil mudah dan ia tidak mempunyai konsol penyampai. Templat ini ialah
amat berguna jika anda menggabungkannya dengan --langkau-nota parameter untuk menyediakan versi
pembentangan anda untuk diletakkan dalam talian.

MEMBUAT PEMBENTANGAN

A ambil perhatian on terminologi
Secara tradisinya, persembahan terdiri daripada slaid. Memanggil mereka "slaid" tidak benar
relevan dalam konteks impress.js, kerana ia boleh bertindih dan tidak semestinya menggelongsor. The
nama "langkah" adalah lebih baik, tetapi ia juga lebih samar-samar. Oleh itu impress.js menggunakan istilah
"slaid" dan "langkah" sebagai bermaksud perkara yang sama, dan begitu juga Hovercraft!

Hoverkraf! sintaks
Pembentangan ialah fail reStructuredText. Jika anda membaca dokumentasi ini dari
kod sumber, maka anda sudah melihat dokumen reStructuredText.

Ia agak mudah, anda menggariskan tajuk untuk menandakannya sebagai tajuk:

Ini menjadi h1
=================

Dan ini h2
-------------

Cara yang berbeza untuk menggariskannya tidak bermakna apa-apa, sebaliknya susunannya
relevan, jadi jenis garis bawah pertama yang ditemui dalam fail akan membuat tahap 1
tajuk, jenis kedua tajuk tahap 2 dan seterusnya. Dalam fail ini = digunakan untuk tahap 1,
dan - untuk tahap 2.

Anda juga boleh menandai teks sebagai italik or berani, Dengan *bujang asterixes* or **berganda asterixes**
masing-masing.

Anda juga boleh mempunyai senarai bullet:

* Peluru 1

* Peluru 1.1

* Peluru 2

* Peluru 3

Dan senarai bernombor:

1. Perkara 1

1.1. Perkara 1.1

2. Perkara 2

3. Perkara 3

Anda boleh memasukkan imej:

.. imej:: laluan/ke/gambar.png
:tinggi: 600px
:lebar: 800px

Seperti yang anda lihat, anda juga boleh menentukan ketinggian dan lebar serta beban yang lain parameter, tetapi mereka
semuanya adalah pilihan.

Dan anda boleh menandakan teks sebagai telah diformatkan. Anda melakukannya dengan menamatkan baris sebelumnya dengan
bertindih berganda, atau mempunyai deretan bertindih berganda dengan sendirinya:

::

Kod ini di sini akan dipraformat
dan ditunjukkan dengan fon monospace
dan semua ruang terpelihara.

Jika anda ingin menambah kod sumber, anda boleh menggunakan kod arahan, dan dapatkan sintaks
mengetengahkan:

.. kod:: python

def some_example_code(foo):
kembali foo * foo

Penonjolan sintaks dilakukan oleh Pigmen dan menyokong banyak dan banyak bahasa.

Anda juga berkemungkinan ingin meletakkan tajuk pada pembentangan. Anda melakukannya dengan mempunyai a ..
tajuk:: kenyataan sebelum slaid pertama:

.. tajuk:: Ini adalah tajuk pembentangan

Itulah perkara paling penting yang anda perlu tahu tentang reStructuredText untuk dibuat
pembentangan. Terdapat banyak lagi yang perlu diketahui, dan banyak ciri lanjutan seperti pautan,
nota kaki, dan banyak lagi. Ia sebenarnya cukup maju supaya anda boleh menulis keseluruhannya buku di dalamnya,
tetapi untuk semua yang anda perlukan untuk membaca dokumentasi.

luar fail
Sebarang fail imej yang dirujuk dalam pembentangan oleh laluan relatif akan disalin ke fail
direktori sasaran, mengekalkan laluan relatifnya kepada pembentangan. Perkara yang sama berlaku untuk imej
atau fon yang dirujuk dalam mana-mana fail CSS yang digunakan oleh pembentangan atau templat.

Imej atau fon yang dirujuk oleh laluan mutlak atau URI tidak akan disalin.

Styling Matlamat Penyampaian
Css yang disertakan oleh templat lalai ialah tiga fail.

· impressConsole.css mengandungi CSS yang diperlukan untuk konsol penyampai berfungsi,

· highlight.css mengandungi gaya lalai untuk penyerlahan sintaks kod, sebaliknya
akan menjadi banyak kerja. Jika anda tidak menyukai warna atau gaya lalai dalam
menyerlahkan, ini ialah fail yang perlu anda salin dan ubah suai.

· hovercraft.css, yang hanya merangkumi minimum: Ia menyembunyikan sandaran impress.js
mesej, nota penyampai, dan menyediakan lalai berguna untuk mempunyai lebar langkah
1000 piksel lebar.

Atas sebab ini anda ingin memasukkan CSS anda sendiri untuk menggayakan slaid anda. Untuk memasukkan CSS
fail yang anda tambahkan a :css:-medan di bahagian atas pembentangan:

:css: css/presentation.css

Anda juga boleh secara pilihan menentukan bahawa css seharusnya hanya sah untuk media CSS tertentu:

:css-screen,projection: css/presentation.css
:css-print: css/print.css

Anda boleh menentukan sebarang bilangan fail css dengan cara ini.

Anda juga boleh menambah satu fail CSS tambahan melalui parameter baris arahan:
hovercraft --extra-css=my_extra.css presentationfile.rst outdir/

Styling a khusus luncurkan
Jika anda ingin mempunyai penggayaan khusus untuk slaid tertentu, adalah idea yang baik untuk memberikannya
slaid ID unik:

:id: the-slide-id

Anda kemudian boleh menggayakan slaid itu secara khusus dengan:

div#the-slide-id {
/* CSS tersuai di sini */
}

Jika anda tidak memberikannya ID tertentu, ia akan mendapat ID berdasarkan nombor urutannya. Dan
ini bermakna ID slaid akan berubah jika anda memasukkan atau mengalih keluar slaid yang datang sebelum itu,
dan dalam kes itu, penggayaan tersuai anda bagi slaid itu akan berhenti berfungsi.

Portable persembahan
Sejak Hovercraft! menjana persembahan HTML5, anda boleh menggunakan mana-mana komputer yang mempunyai a
pelayar moden dipasang untuk melihat atau menunjukkan pembentangan. Ini membolehkan anda berdua untuk meletakkan
pembentangan dalam talian dan menggunakan komputer yang dipinjam untuk persidangan atau pelanggan anda
persembahan.

Apabila anda mengembara, anda tidak tahu peralatan yang anda perlu gunakan apabila anda menunjukkan peralatan anda
presentaton, dan ia adalah perkara biasa untuk menemui projektor yang enggan bercakap dengannya
komputer anda. Ia juga sangat mudah untuk melupakan dongle anda jika anda mempunyai MacBook, dan di sana
malah pernah berlaku kes komputer menjadi gelap dan mati sepenuhnya apabila anda menyambungkannya
projektor, walaupun semua komputer lain kelihatan berfungsi dengan baik.

Cara utama untuk memastikan pembentangan anda mudah alih adalah dengan mencubanya pada cara yang berbeza
pelayar dan komputer yang berbeza. Tetapi yang terakhir boleh menjadi tidak boleh dilaksanakan, tidak semua orang mempunyai kedua-duanya
Komputer Windows, Linux dan OS X di rumah. Untuk membantu menjadikan pembentangan anda mudah alih ia adalah
idea yang baik untuk menentukan @font-face anda sendiri dan menggunakannya, jadi anda pasti sasaran itu
penyemak imbas akan menggunakan fon yang sama seperti yang anda lakukan. Hoverkraf! akan mencari @font-face secara automatik
definisi dan salin fail fon ke direktori sasaran.

impress.js bidang
Dokumentasi pada impress.js terkandung sebagai ulasan dalam demo html fail. Bukan
sentiasa sangat jelas, jadi inilah ringkasan ringkas untuk kemudahan.

Medan data berbeza yang impress.js akan digunakan dalam 0.5.3, iaitu versi semasa,
adalah yang berikut:

· tempoh peralihan data: Masa yang diperlukan untuk bergerak dari satu slaid ke slaid yang lain.
Lalai kepada 1000 (1 saat). Ini hanya sah pada pembentangan secara keseluruhan.

· perspektif data: Mengawal "perspektif" dalam kesan 3d. Ia lalai kepada 500.
Menetapkannya kepada 0 melumpuhkan kesan 3D.

· data-x: Kedudukan mendatar slaid dalam piksel. Boleh jadi negatif.

· data-y: Kedudukan menegak slaid dalam piksel. Boleh jadi negatif.

· skala data: Menetapkan skala slaid, yang menghasilkan zum. Lalai kepada 1. A
nilai 4 bermakna slaid adalah empat kali lebih besar. Pendek kata: Rendah bermaksud zum masuk,
lebih tinggi bermakna zum keluar.

· data-putar-z: Putaran slaid dalam paksi-x, dalam darjah. Ini akan menyebabkan
gelongsor untuk diputar mengikut arah jam atau lawan jam.

· putaran data: Sama seperti data-putar-z.

· data-putar-x: Putaran slaid dalam paksi-x, dalam darjah. Ini bermakna anda
menggerakkan slaid dalam dimensi ketiga berbanding slaid lain. Ini secara amnya
kesan sejuk, jika digunakan dengan betul.

· data-putar-y: Putaran slaid dalam paksi-x, dalam darjah.

· data-z: Ini mengawal kedudukan slaid pada paksi-z. Menetapkan nilai ini kepada
-3000 bermakna ia diposisikan -3000 piksel jauhnya. Ini hanya berguna apabila anda menggunakan
data-putar-x or data-putar-y, jika tidak ia hanya akan memberi gambaran bahawa
slaid dibuat lebih kecil, yang tidak begitu berguna.

Hoverkraf! kepakaran
Hoverkraf! mempunyai beberapa cara khusus ia menggunakan reStructuredText. Pertama sekali, yang
"peralihan" reStructuredText digunakan untuk menandakan pemisahan antara slaid yang berbeza atau
langkah-langkah. Peralihan hanyalah garis dengan empat atau lebih sempang:

----

Anda tidak perlu menggunakan tanda sempang, anda boleh menggunakan mana-mana aksara yang digunakan untuk menggariskan
tajuk, = - ` : . ' " ~ ^ _ * + #. Dan sama seperti tajuk lebar, menggunakan berbeza
aksara menunjukkan "tahap" yang berbeza. Dengan cara ini anda boleh membuat hierarki
pembentangan, dengan langkah dan sublangkah. Walau bagaimanapun, impress.js tidak menyokong itu, jadi ini
hanya berguna jika anda membuat templat anda sendiri yang menggunakan perpustakaan Javascript lain, untuk
contoh Reveal.js. Jika anda mempunyai lebih daripada satu tahap peralihan dengan templat disertakan
dengan Hovercraft, persembahan yang terhasil mungkin berkelakuan pelik.

Semua medan reStructuredText ditukar kepada atribut pada teg semasa. Kebanyakan daripada
ini biasanya akan diabaikan oleh pemaparan kepada HTML, tetapi terdapat dua tempat di mana
teg akan membuat perbezaan, dan itu adalah dengan meletakkannya dahulu dalam dokumen, atau
pertama pada slaid.

Sebarang medan yang anda letakkan dahulu dalam dokumen akan dijadikan atribut pada utama
impress.js . Pada masa ini, ini hanya digunakan untuk menetapkan tempoh peralihan dengan
tempoh peralihan data.

Sebarang medan yang anda letak dahulu dalam slaid akan dijadikan atribut pada slaid .
Ini digunakan terutamanya untuk menetapkan kedudukan/zum/putaran slaid, sama ada dengan
data-x, data-y dan tetapan impress.js lain, atau laluan hoverkraf tetapan, lebih lanjut mengenai itu
kemudian.

Hoverkraf! akan mula membuat slaid pertama apabila ia mula-mula menemui sama ada peralihan
atau tajuk. Semua yang datang sebelum itu akan menjadi milik pembentangan secara keseluruhan.

Oleh itu, persembahan boleh kelihatan seperti ini:

:data-transition-tempoh: 2000
:skip-help: benar

.. tajuk: Tajuk Persembahan

----

Ini adalah slaid pertama
=======================

Ini datang beberapa teks.

----

:data-x: 300
:data-y: 2000

Ini adalah slaid kedua
==========================

#. Di sini kita ada

#. Senarai bernombor

#. Ia akan menjadi betul

#. Nombor secara automatik

Relatif kedudukan
Hoverkraf! memberi anda keupayaan untuk meletakkan slaid secara relatif antara satu sama lain. Awak buat ini
dengan memulakan koordinat dengan "r". Ini akan meletakkan slaid 500 piksel ke kanan
dan seribu piksel di atas slaid sebelumnya:

:data-x: r500
:data-y: r-1000

Laluan relatif membolehkan anda memasukkan dan mengalih keluar slaid dan menyelaraskan slaid lain
secara automatik. Ia mungkin cara yang paling berguna untuk meletakkan kedudukan.

automatik kedudukan
Jika anda tidak menentukan atribut, tetapan slaid akan sama seperti sebelumnya
gelongsor. Ini bermakna jika anda menggunakan kedudukan relatif, slaid seterusnya akan mengalihkan
jarak yang sama.

Ini memberikan pergerakan linear, dan slaid anda akan berakhir dalam garis lurus.

Secara lalai pergerakannya ialah 1600 piksel ke kanan, yang bermaksud jika anda tidak melakukannya
meletakkan mana-mana slaid sama sekali, anda mendapat persembahan standard di mana slaid akan mudah
gelongsor dari kanan ke kiri.

SVG Laluan
Hoverkraf! menyokong slaid kedudukan di sepanjang laluan SVG. Ini berguna, seperti yang anda boleh
buat lukisan dalam perisian yang menyokong SVG, dan kemudian salin-tampal laluan lukisan itu
ke dalam pembentangan anda.

Anda menentukan laluan SVG dengan :hoverkraf-laluan: padang. Sebagai contoh:

:laluan hoverkraf: m275,175 v-150 a150,150 0 0,0 -150,150 z

Setiap slaid berikut yang tidak mempunyai sebarang kedudukan yang jelas akan diletakkan pada ini
laluan.

Terdapat beberapa perkara yang anda perlu berhati-hati apabila menggunakan laluan SVG.

Relatif and mutlak koordinat
Dalam SVG koordinat boleh sama ada mutlak, dengan rujukan kepada asal halaman; atau
relatif, yang merujuk kepada perkara terakhir. Hoverkraf! boleh mengendalikan kedua-duanya, tetapi apa
ia tidak boleh mengendalikan dengan baik adalah campuran daripada mereka.

Khususnya, jika anda mengambil laluan SVG yang bermula dengan pergerakan relatif dan ekstrak
bahawa daripada dokumen SVG, anda akan kehilangan konteks. Semua koordinat kemudian mesti kemudian
juga bersifat relatif. Jika anda mempunyai penyelaras mutlak, anda tiba-tiba mendapatkan semula konteks,
dan segala-galanya selepas koordinat mutlak pertama akan tersasar berbanding dengan
mata yang datang sebelum ini.

Paling ketara, perisian sumber terbuka "Inkscape" akan bercampur mutlak dan relatif
koordinat, jika anda membenarkannya menggunakan koordinat relatif. Oleh itu anda perlu pergi ke
ia tetapan dan nyahtanda kotak semak yang membolehkan anda menggunakan koordinat relatif. ini
memaksa Inkscape untuk menyimpan semua koordinat sebagai mutlak, yang akan berfungsi dengan baik.

Start kedudukan
Secara lalai kedudukan permulaan laluan, dan oleh itu kedudukan permulaan laluan pertama
slaid, akan menjadi apa sahaja kedudukan permulaan jika slaid tidak mempunyai kedudukan
sama sekali. Jika anda ingin menukar kedudukan ini maka masukkan sahaja :data-x: or :data-y: bidang.
Kedua-dua kedudukan relatif dan mutlak akan berfungsi di sini.

Dalam semua kes, yang pertama m or M arahan laluan SVG diabaikan dengan berkesan, tetapi anda
kena masukkan pula.

SVG jelmaan
SVG membolehkan anda membuat laluan dan kemudian mengubahnya. Hoverkraf! tidak mempunyai sokongan untuk ini
berubah, jadi sebelum anda mengekstrak laluan anda harus memastikan perisian SVG tidak
menggunakan transformasi. Dalam Inkscape anda boleh melakukan ini dengan arahan "Simplify".

lain-lain SVG bentuk
Hoverkraf! tidak menyokong bentuk SVG lain, hanya laluan. Ini kerana penganjuran
slaid dalam segi empat sama, dsb, agak mudah juga, dan bentuknya boleh dijadikan laluan.
Biasanya dalam perisian anda perlu memilih bentuk dan memberitahu perisian anda untuk dibuat
ia ke jalan. Dalam Inkscape, mengubah objek menjadi laluan secara amnya bermakna itu
keseluruhan laluan dibuat daripada lengkung CubicBezier, yang tidak perlu rumit. Menggunakan
Perintah "Simplify" dalam Inkscape biasanya cukup untuk menjadikan bentuk menjadi laluan.

Penskalaan bentuk
Hoverkraf! akan skala laluan supaya semua slaid yang perlu dimuatkan ke dalam laluan akan
sesuai dengan laluan. Oleh itu, jika anda mempunyai beberapa laluan dalam pembentangan anda, mereka akan melakukannya tidak
kekalkan saiz relatifnya, tetapi akan diubah saiznya supaya slaid sesuai. Jika anda perlu mempunyai
bentuk mengekalkan saiz relatifnya, anda perlu menggabungkannya menjadi satu laluan.

Contoh
Untuk melihat cara menggunakan Hovercraft! dalam amalan, terdapat tiga contoh pembentangan disertakan
dengan Hovercraft!

hovercraft.pertama
Persembahan demo yang anda boleh lihat di http://regebro.github.com/hovercraft

tutorial.pertama
Panduan langkah demi langkah untuk ciri Hovercraft!

jawatan.pertama
Penjelasan tentang cara menggunakan ciri kedudukan.

MEREKA BENTUK ANDA PEMBENTANGAN

Terdapat beberapa helah untuk membuat pembentangan. Saya sememangnya tidak mengaku sebagai seorang
pakar, tetapi berikut adalah beberapa petua pemula.

Mengambil it mudah
Jangan terlalu berat pada zum. Mempunyai perbezaan antara dua slaid dalam skala lebih
daripada 5 jarang kelihatan baik. Ia akan menghasilkan kesan zum sejuk yang bagus jika ia
melakukannya, tetapi ini bukan untuk tujuan penyemak imbas, jadi ia tidak.

Dan kesan 3D boleh menjadi sangat keren jika digunakan dengan baik. Tetapi tidak setiap masa, ia menjadi penat
untuk penonton.

Cuba, jika boleh, gunakan zum dan kesan 3D apabila ia masuk akal dalam pembentangan.
Anda boleh sebagai contoh menyebut topik utama pada satu slaid, dan kemudian zum masuk pada setiap topik
apabila anda membincangkannya dengan lebih terperinci. Dengan cara itu kesan membantu menjelaskan pembentangan,
bukannya mengalihkan perhatian daripadanya.

Adat fon
Penyemak imbas cenderung untuk membuat sesuatu secara halus berbeza.

Mereka juga mempunyai fon lalai yang berbeza, dan sistem pengendalian yang berbeza mempunyai berbeza
pelaksanaan fon yang sama. Jadi untuk memastikan anda mempunyai banyak kawalan ke atas
reka bentuk yang mungkin, anda harus sentiasa memasukkan fon dengan pembentangan. Sumber yang bagus
untuk fon percuma ialah Google Webfonts. Fon tersebut adalah percuma dan sumber terbuka, jadi anda boleh menggunakannya
mereka tanpa kos dan tiada risiko untuk disaman. Mereka juga boleh dimuat turun atau disertakan
dalam talian.

Talian vs Dikemaskini
Jika anda membuat pembentangan yang akan dijalankan pada komputer anda pada persidangan atau
mesyuarat pelanggan, sentiasa muat turun fon dan jadikannya sebagai sebahagian daripada pembentangan.
Letakkannya dalam folder bernama fon di bawah folder tempat pembentangan anda.

Anda juga perlu menentukan keluarga fon dalam CSS anda. Fon Tupaipenjana webfont
akan memberikan anda kit alat bebas platform untuk menjana kedua-dua fon varius
format dan CSS.

Jika pembentangan dalam talian sahaja, anda boleh meletakkan @termasuk-penyataan dalam CSS anda untuk
sertakan fon web Google secara langsung:

@import url(http://fonts.googleapis.com/css?family=Libre+Baskerville|Racing+Sans+One|Puaskan);

Tetapi jangan gunakan ini untuk perkara yang anda perlu tunjukkan pada komputer anda, kerana ia memerlukan anda
mempunyai akses internet.

ujian bersama berbeza pelayar
Jika anda meletakkan pembentangan dalam talian, uji dengan beberapa pelayar utama, untuk
pastikan tiada yang rosak dan semuanya masih kelihatan baik. Bukan sahaja ada halus
perbezaan dalam cara sesuatu boleh diposisikan, pelayar yang berbeza juga mahir
Perkara yang berbeza.

Saya telah menguji beberapa penyemak imbas, semuanya pada Ubuntu, dan berkemungkinan ia berkelakuan berbeza pada
sistem pengendalian lain, jadi anda perlu mencuba sendiri.

Firefox
Firefox 18 agak lambat digunakan dengan impress.js, terutamanya untuk barangan 3D, jadi ia boleh
pergerakan yang sangat tersentak dari gelongsor ke gelongsor. Ia memastikan teks kelihatan baik tidak kira bagaimana caranya
banyak yang anda zum. Sebaliknya, ia enggan menskalakan teks tanpa had, jadi jika anda juga menskalakan
banyak watak tidak akan membesar, sebaliknya akan mula bergerak.

Firefox 19 adalah lebih baik, tetapi untuk barangan 3D ia masih agak perlahan.

Chrome
Chrome 24 adalah pantas, tetapi tidak akan melukis semula teks dalam saiz yang berbeza, sebaliknya akan membuat
imej mereka dan skala semula mereka, menyebabkan slaid sebelumnya mempunyai pixelated kabur
kesan.

Epiphany
Epiphany 3.4.1 adalah setanding dengan Firefox 19, mungkin sedikit lebih lancar, dan teks kelihatan
baik. Tetapi ia mempunyai pepijat dalam cara ia mengendalikan data 3D, dan bar lokasi boleh dilihat di dalamnya
mod skrin penuh, menjadikannya kurang sesuai untuk sebarang jenis pembentangan.

Kerangka

Nasib baik, untuk kebanyakan kes anda tidak perlu membuat templat anda sendiri, sebagai lalai
templat adalah sangat mudah dan kebanyakan perkara yang anda perlu lakukan boleh dilakukan dengan css. Walau bagaimanapun, saya
tidak mahu Hovercraft! untuk menyediakan dinding yang tidak cukup fleksibel untuk keperluan anda, jadi
Saya menambah sokongan untuk membuat templat anda sendiri.

Anda perlu mencipta templat anda sendiri jika anda tidak berpuas hati dengan HTML yang Hovercraft!
menjana, contohnya jika anda perlu menggunakan versi HTML yang lain atau jika
reStructuredText yang anda gunakan tidak dipaparkan dalam cara yang berguna untuk anda.
Walaupun jika anda tidak berpuas hati dengan HTML yang dihasilkan daripada reStructuredText yang boleh
sangat baik menjadi pepijat, jadi buka isu pada Github untuk perbincangan.

Hoverkraf! menjana pembentangan dengan menukar reStructuredText kepada XML dan kemudian
menggunakan XSLT untuk menterjemah XML ke dalam HTML.

Templat ialah direktori dengan fail konfigurasi, fail XSL templat dan sebarang nombor
CSS, JS dan fail sumber lain.

. template konfigurasi fail
Fail konfigurasi biasanya dipanggil template.cfg, tetapi jika anda mempunyai beberapa
fail konfigurasi dalam satu direktori templat, anda boleh menentukan yang mana satu untuk digunakan
menentukan laluan penuh ke fail konfigurasi. Walau bagaimanapun, jika anda hanya menentukan
direktori templat, template.cfg akan digunakan.

Fail templat adalah dalam format configparser, yang merupakan format gaya ini yang dilanjutkan. Mereka adalah
sangat mudah, dan hanya mempunyai satu bahagian, [hoverkraf]. Mana-mana bahagian lain akan diabaikan.
Kebanyakan parameter adalah senarai yang selalunya tidak sesuai pada satu baris. Dalam kes itu anda boleh
belah baris ke atas beberapa baris, tetapi inden garisan. Jumlah lekukan
tidak membuat apa-apa perbezaan, kecuali dari segi estetika.

Parameter dalam bahagian [hoverkraf] ialah:
templat Nama templat xsl.

css A senarai of CSS nama fail dipisahkan by ruang kosong. Ini fail
akan dimasukkan ke dalam fail akhir dengan "semua" sebagai spesifikasi media.

css- A senarai of CSS nama fail dipisahkan by ruang kosong. Ini fail
akan dimasukkan ke dalam fail akhir dengan media yang diberikan dalam parameter. Jadi
fail yang disenaraikan untuk parameter "css-print" akan mendapat "cetak" sebagai medianya
spesifikasi dan kunci seperti "css-screen,print" akan mengembalikan media
"cetak skrin".

js-header A senarai of nama fail dipisahkan by ruang kosong. Ini fail
akan dimasukkan ke dalam fail sasaran sebagai pautan skrip pengepala.

js-body A senarai of nama fail dipisahkan by ruang kosong. Ini fail
akan dimasukkan ke dalam fail sasaran sebagai pautan skrip pada penghujung fail. The
fail impress.js, impressConsole.js dan hovercraft.js biasanya perlu
disertakan di sini.

sumber A senarai of nama fail dipisahkan by ruang kosong Bahawa akan be
disalin ke direktori sasaran, tetapi tiada perkara lain yang dilakukan dengannya. Imej dan
fon yang digunakan oleh CSS akan disalin juga, tetapi sumber lain boleh ditambah di sini.

Satu contoh:

[hoverkraf]
templat = templat.xsl

css = css/screen.css
css/impressConsole.css

css-print = css/print.css

js-header = js/dateinput.js

js-body = js/impress.js
js/impressConsole.js
js/hovercraft.js

sumber = images/back.png
images/forward.png
images/up.png
images/down.png

. template fail
Fail yang dinyatakan dengan template parameter ialah templat XSLT sebenar yang akan
melaksanakan terjemahan daripada XML ke HTML.

Selalunya anda hanya boleh menyalin fail templat lalai
hovercraft/templates/default/template.xsl dan mengubah suainya. XSLT sangat kompleks, tetapi
mengubah suai templat HTML adalah agak mudah selagi anda tidak perlu menyentuh
mana-mana tags.

Selain itu, HTML yang dihasilkan adalah serasi dengan XHTML dan agak mudah, jadi untuk
kebanyakan kes semua yang anda perlukan untuk menjana versi HTML yang lain, contohnya ketat
XHTML, adalah untuk menukar doctype.

Tetapi jika anda perlu menambah atau menukar HTML yang dijana utama anda boleh menambah dan menukar HTML
penyata dalam fail utama ini mengikut kehendak anda. Lihat sebagai contoh bagaimana pop timbul bantuan kecil itu
ditambahkan ke bahagian bawah HTML.

Jika anda ingin menukar cara reStructuredText diberikan, perkara menjadi lebih sedikit
kompleks. Peraturan XSLT yang menukar reStructuredText XML kepada HTML terkandung dalam a
fail berasingan, reST.xsl. Untuk sebahagian besar anda hanya boleh memasukkannya ke dalam fail templat
dengan kod berikut:



. sumber: bahagian di sini bukan sebahagian daripada XSLT, tetapi sebahagian daripada Hovercraft! Ia memberitahu
Terjemahan XSLT bahawa fail yang dinyatakan tidak seharusnya dicari pada sistem fail, tetapi
sebagai sumber pakej Python. Pada masa ini templat/reST.xsl fail adalah satu-satunya XSLT
import sumber tersedia.

Jika anda perlu menukar cara reStructuredText dipaparkan, anda perlu membuat salinannya
fail dan ubah suainya. Anda kemudiannya perlu membuat salinan templat utama dan menukar templat
rujukan di dalamnya kepada fail XSLT anda yang diubah suai.

Tiada fail XSLT perlu disalin ke sasaran, dan tidak boleh disenaraikan sebagai a
sumber dalam fail konfigurasi templat.

Gunakan hoverkraf dalam talian menggunakan perkhidmatan onworks.net