unduhan landslide - pengunduhan kode sumber landslide

landslide

Kode sumber lainnya

1.0.0

Unduh

Tanah longsor

Longsor menghasilkan tayangan slide menggunakan penurunan harga, ReST, atau tekstil. Itu dibangun dari template html5slides Google.

Penurunan harga berikut menghasilkan tayangan slide ini.

 # Landslide

---

# Overview

Generate HTML5 slideshows from markdown, ReST, or textile.

![python](http://i.imgur.com/bc2xk.png)

Landslide is primarily written in Python, but it's themes use:

- HTML5
- Javascript
- CSS

---

# Code Sample

Landslide supports code snippets

    !python
    def log(self, message, level='notice'):
        if self.logger and not callable(self.logger):
            raise ValueError(u"Invalid logger set, must be a callable")

        if self.verbose and self.logger:
            self.logger(message, level)

Persyaratan

python dan modul berikut:

jinja2
pygments untuk pewarnaan sintaksis blok kode

Konversi Markup

markdown untuk penurunan harga
docutils untuk Teks Terstruktur ulang
textile untuk Tekstil

Opsional

watchdog untuk menonton/regenerasi otomatis dengan bendera -w
Pangeran untuk ekspor PDF

Instalasi

Instal Landslide versi stabil terbaru dengan manajer paket python seperti pip :

 $ pip install landslide

Jika Anda ingin tetap berada di ujung tanduk:

 $ git clone https://github.com/adamzap/landslide.git
$ cd landslide
$ python setup.py build
$ sudo python setup.py install

Pemformatan

Penurunan harga

File sumber Markdown Anda harus diakhiri dengan .md , .markdn , .mdwn , .mdown atau .markdown
Untuk membuat judul slide, render satu elemen h1 (mis. # My Title )
Pisahkan slide Anda dengan aturan horizontal ( --- dalam penurunan harga) kecuali di akhir file md
Slide Anda yang lain harus memiliki judul yang dirender ke elemen h1
Untuk menyorot blok kode, letakkan !lang di mana lang adalah pengidentifikasi bahasa yang didukung pigmen sebagai baris pertama yang menjorok ke dalam

Teks Terstruktur Ulang

File sumber ReST Anda harus diakhiri dengan .rst atau .rest ( .txt tidak didukung )
Gunakan judul untuk judul slide
Pisahkan slide Anda menggunakan aturan horizontal ( ---- di RST) kecuali di akhir file RST

Tekstil

Pisahkan slide Anda menggunakan --- , seperti pada penurunan harga

Render

Jalankan landslide slides.md atau landslide slides.rst
Nikmati presentation.html Anda yang baru dibuat

Atau dapatkan sebagai dokumen PDF jika Prince diinstal dan tersedia di sistem Anda:

 $ landslide README.md -d readme.pdf
$ open readme.pdf

Melihat

Tekan h untuk beralih tampilan bantuan
Tekan left arrow dan right arrow untuk bernavigasi
Tekan t untuk mengganti daftar isi presentasi Anda. Judul slide adalah tautan
Tekan ESC untuk menampilkan gambaran umum presentasi (Exposé)
Tekan n untuk mengubah visibilitas nomor slide
Tekan b untuk mengaktifkan pengosongan layar
Tekan c untuk mengganti konteks slide saat ini (slide sebelumnya dan berikutnya)
Tekan e untuk membuat slide mengisi seluruh ruang yang tersedia di badan dokumen
Tekan S untuk mengalihkan tampilan tautan ke file sumber untuk setiap slide
Tekan '2' untuk mengganti catatan di slide Anda (tentukan dengan makro .notes)
Tekan '3' untuk mengaktifkan tampilan pseudo-3D (eksperimental)
Pembesaran browser didukung

Opsi Baris Perintah

Beberapa opsi tersedia menggunakan baris perintah:

 -h, --help            show this help message and exit
-c, --copy-theme      Copy theme directory into current presentation source
                      directory
-b, --debug           Will display any exception trace to stdin
-d FILE, --destination=FILE
                      The path to the to the destination file: .html or .pdf
                      extensions allowed (default: presentation.html)
-e ENCODING, --encoding=ENCODING
                      The encoding of your files (defaults to utf8)
-i, --embed           Embed stylesheet and javascript contents,
                      base64-encoded images in presentation to make a
                      standalone document
-l LINENOS, --linenos=LINENOS
                      How to output linenos in source code. Three options
                      availables: no (no line numbers); inline (inside                       tag); table (lines numbers in another cell, copy-paste
                      friendly)
-o, --direct-output    Prints the generated HTML code to stdout; won't work
                      with PDF export
-q, --quiet           Won't write anything to stdout (silent mode)
-r, --relative        Make your presentation asset links relative to current
                      pwd; This may be useful if you intend to publish your
                      html presentation online.
-t THEME, --theme=THEME
                      A theme name, or path to a landlside theme directory
-v, --verbose         Write informational messages to stdin (enabled by
                      default)
-w, --watch           Watch the source directory for changes and
                      auto-regenerate the presentation
-x EXTENSIONS, --extensions=EXTENSIONS
                      Comma-separated list of extensions for Markdown
-m, --math-output     Enable mathematical output using mathjax

Konfigurasi Presentasi

Landslide memungkinkan untuk mengonfigurasi presentasi Anda menggunakan file konfigurasi cfg , sehingga memudahkan agregasi direktori sumber dan penggunaannya kembali di seluruh presentasi. File konfigurasi tanah longsor menggunakan sintaks cfg . Jika Anda mengetahui file ini , Anda mendapatkan gambarnya. Di bawah ini adalah contoh file konfigurasi:

 [landslide]
theme  = /path/to/my/beautiful/theme
source = 0_my_first_slides.md
         a_directory
         another_directory
         now_a_slide.markdown
         another_one.rst
destination = myWonderfulPresentation.html
css =    my_first_stylesheet.css
         my_other_stylesheet.css
js =     jquery.js
         my_fancy_javascript.js
relative = True
linenos = inline

Jangan lupa mendeklarasikan bagian [landslide] . Semua file konfigurasi harus diakhiri dengan ekstensi .cfg.

Untuk menghasilkan presentasi seperti yang dikonfigurasi, jalankan saja:

 $ cd /path/to/my/presentation/sources
$ landslide config.cfg

Makro

Anda dapat menggunakan makro untuk menyempurnakan presentasi Anda:

Catatan

Tambahkan catatan ke slide Anda menggunakan kata kunci .notes: :, misalnya:

 # My Slide Title

.notes: These are my notes, hidden by default

My visible content goes here

Anda dapat mengganti tampilan catatan dengan menekan tombol 2 .

Beberapa makro lainnya juga tersedia secara default: .fx: foo bar akan menambahkan kelas foo dan bar ke elemen

slide yang sesuai, sehingga memudahkan penataan gaya presentasi Anda menggunakan CSS.

Kode QR

Tambahkan Kode QR ke presentasi Anda dengan menggunakan kata kunci .qr :

 .qr: 450|http://github.com/adamzap/landslide

Catatan Penyaji

Anda juga dapat menambahkan catatan penyaji pada setiap slide dengan mengikuti isi slide dengan judul berjudul "Catatan Penyaji". Tekan tombol 'p' untuk membuka tampilan presenter.

Mendaftarkan Makro

Makro digunakan untuk mengubah konten HTML slide Anda.

Anda dapat mendaftarkan makro Anda sendiri dengan membuat kelas turunan landslide.macro.Macro , mengimplementasikan metode process(content, source=None) dan mengembalikan Tupel yang berisi konten yang dimodifikasi dan beberapa kelas css yang mungkin ingin Anda tambahkan ke slide Anda

elemen. Misalnya:

 !python
import landslide

class MyMacro(landslide.Macro):
  def process(self, content, source=None):
    return content + 'plop', ['plopped_slide']

g = landslide.generator.Generator(source='toto.md')
g.register_macro(MyMacro)
print g.render()

Ini akan membuat slide apa pun seperti di bawah ini:

 !html

  foo
  
    my slide contents
    plop

Penggunaan Tingkat Lanjut

Mengatur File Tujuan Khusus

 $ landslide slides.md -d ~/MyPresentations/presentation.html

Bekerja dengan Direktori

 $ landslide slides/

Bekerja dengan Output Langsung

 $ landslide slides.md -o | tidy

Menggunakan Tema Alternatif Longsor

 $ landslide slides.md -t mytheme
$ landslide slides.md -t /path/to/theme/dir

Menyematkan Gambar Berkode Base-64

 $ landslide slides.md -i

Mengekspor ke PDF

 $ landslide slides.md -d presentation.pdf

Mengaktifkan notasi matematika

 Note that this require writing the slides in ReST format as well as
using Docutils 0.8 or newer.

$ landslide slides.rst -m

Mengaktifkan Ekstensi Penurunan Harga

Lihat dokumentasi tentang ekstensi Markdown yang tersedia di sini:

 $ landslide slides.md -x abbr

Tema

Tema Longsor adalah direktori yang mengikuti struktur sederhana ini:

 mytheme/
|-- base.html
|-- css
|   |-- print.css
|   `-- screen.css
`-- js
    `-- slides.js

Jika suatu tema tidak menyediakan file HTML dan JS, maka file dari tema default akan digunakan. CSS bukanlah opsional.

Terakhir, Anda juga dapat menyalin seluruh direktori tema ke presentasi Anda dengan meneruskan opsi --copy-theme ke perintah landslide :

 $ landslide slides.md -t /path/to/some/theme --copy-theme

Lembar gaya pengguna dan Javascript

Jika Anda tidak ingin repot membuat tema sendiri, Anda bisa memasukkan file css dan js pengguna Anda sendiri ke presentasi yang dihasilkan.

Fitur ini hanya tersedia jika Anda menggunakan file konfigurasi longsor, dengan menyetel flag css dan/atau js :

 [landslide]
theme  = /path/to/my/beautiful/theme
source = slides.mdown
css =    custom.css
js =     jquery.js
         powerpoint.js

Ini akan menghubungkan stylesheet custom.css dan file jquery.js dan powerpoint.js dalam bagian pada file html presentasi.

CATATAN: Jalur ke file css dan js harus relatif terhadap direktori tempat Anda menjalankan perintah landslide .

Publikasikan Presentasi Anda Secara Online

Jika Anda ingin mempublikasikan presentasi HTML Anda secara online, Anda harus menggunakan opsi --relative , serta opsi --copy-theme untuk memiliki semua tautan aset yang berhubungan dengan akar presentasi Anda;

 $ landslide slides.md --relative --copy-theme

Dengan begitu, Anda hanya perlu meng-host seluruh direktori presentasi ke server web. Tentu saja, tidak diperlukan Python, PHP, atau apa pun selain server web HTTP (seperti Nginx) untuk menyelenggarakan presentasi besar-besaran.

Variabel Tema

base.html harus berupa file templat Jinja2 tempat Anda dapat memanfaatkan variabel templat berikut:

css : isi stylesheet, tersedia melalui dua tombol, print dan screen , keduanya memiliki:
- kunci path_url yang menyimpan url ke jalur file aset
- kunci contents yang menyimpan konten aset
js : isi javascript, memiliki:
- kunci path_url yang menyimpan url ke jalur file aset
- kunci contents yang menyimpan konten aset
slides : daftar slide, masing-masing memiliki properti berikut:
- header : judul slide
- content : isi slide
- number : nomor slide
embed : apakah dokumen saat ini merupakan dokumen yang berdiri sendiri?
num_slides : jumlah slide dalam presentasi saat ini
toc : Daftar Isi, mencantumkan bagian-bagian dokumen. Setiap bagian memiliki properti berikut yang tersedia:
- title : judul bagian
- number : nomor slide bagian
- sub : subbagian, jika ada

Lingkup Gaya

Untuk mengubah gaya presentasi HTML5, sesuaikan stylesheet css/screen.css yang disertakan dengan tema yang Anda gunakan
Untuk PDF, ubah css/print.css