landslide 다운로드 - landslide 소스 코드 다운로드

landslide

기타 소스코드

1.0.0

다운로드

산사태

Landslide는 마크다운, ReST 또는 직물을 사용하여 슬라이드쇼를 생성합니다. 이는 Google의 html5slides 템플릿을 기반으로 구축되었습니다.

다음 마크다운은 이 슬라이드쇼를 생성합니다.

 # 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)

요구사항

python 및 다음 모듈:

jinja2
코드 블록 구문 색상에 대한 pygments

마크업 변환

마크다운을 위한 markdown
재구성된 텍스트를 위한 docutils
섬유용 textile

선택 과목

-w 플래그를 사용하여 감시/자동 재생성을 위한 watchdog
PDF 내보내기용 Prince

설치

pip 와 같은 Python 패키지 관리자를 사용하여 Landslide의 최신 안정 버전을 설치하십시오.

 $ pip install landslide

최신 상태를 유지하고 싶다면:

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

서식 지정

가격 인하

Markdown 소스 파일에는 .md , .markdn , .mdwn , .mdown 또는 .markdown 접미사가 붙어야 합니다.
제목 슬라이드를 만들려면 단일 h1 요소를 렌더링합니다(예: # My Title )
md 파일의 끝 부분을 제외하고 가로줄(마크다운에서는 --- )로 슬라이드를 구분하세요.
다른 슬라이드에는 h1 요소로 렌더링되는 제목이 있어야 합니다.
코드 블록을 강조 표시하려면 !lang 입력하세요. 여기서 lang 첫 번째 들여쓰기 행으로 피그먼트에서 지원하는 언어 식별자입니다.

재구성된 텍스트

ReST 소스 파일에는 .rst 또는 .rest 라는 접미사가 붙어야 합니다( .txt 지원되지 않음 ).
슬라이드 제목에 제목 사용
RST 파일 끝 부분을 제외하고 가로줄(RST에서는 ---- )을 사용하여 슬라이드를 구분합니다.

직물

마크다운에서처럼 --- 사용하여 슬라이드를 분리하세요.

표현

landslide slides.md 또는 landslide slides.rst 실행합니다.
새로 생성된 presentation.html 을 즐겨보세요.

또는 시스템에 Prince가 설치되어 사용 가능한 경우 PDF 문서로 가져옵니다.

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

보기

도움말 표시를 전환하려면 h 누르세요.
탐색하려면 left arrow 와 right arrow 누르세요.
프레젠테이션의 목차를 전환하려면 t 누르세요. 슬라이드 제목은 링크입니다.
프레젠테이션 개요를 표시하려면 ESC 누르세요(Exposé).
슬라이드 번호 표시 여부를 전환하려면 n 누르세요.
화면 공백을 전환하려면 b 누르세요.
현재 슬라이드 컨텍스트(이전 및 다음 슬라이드)를 전환하려면 c 누르세요.
문서 본문 내에서 사용 가능한 전체 공간을 채우는 슬라이드를 만들려면 e 누르세요.
S 눌러 각 슬라이드의 소스 파일에 대한 링크 표시를 전환합니다.
슬라이드의 메모를 전환하려면 '2'를 누르세요(.notes 매크로로 지정).
의사 3D 디스플레이를 전환하려면 '3'을 누르세요(실험적).
브라우저 확대/축소가 지원됩니다.

명령줄 옵션

명령줄을 사용하면 여러 가지 옵션을 사용할 수 있습니다.

 -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

프레젠테이션 구성

Landslide를 사용하면 cfg 구성 파일을 사용하여 프리젠테이션을 구성할 수 있으므로 소스 디렉토리를 쉽게 통합하고 프리젠테이션 전체에서 재사용할 수 있습니다. Landslide 구성 파일은 cfg 구문을 사용합니다. ini 파일을 알고 있다면 그림을 얻을 수 있습니다. 다음은 샘플 구성 파일입니다.

 [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

[landslide] 섹션을 선언하는 것을 잊지 마세요. 모든 구성 파일은 .cfg 확장자로 끝나야 합니다.

구성된 대로 프레젠테이션을 생성하려면 다음을 실행하세요.

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

매크로

매크로를 사용하여 프레젠테이션을 향상할 수 있습니다.

메모

.notes: 키워드를 사용하여 슬라이드에 메모를 추가하세요. 예:

 # My Slide Title

.notes: These are my notes, hidden by default

My visible content goes here

2 키를 눌러 음표 표시를 전환할 수 있습니다.

일부 다른 매크로도 기본적으로 사용할 수 있습니다. .fx: foo bar 해당 슬라이드

요소에 foo 및 bar 클래스를 추가하여 CSS를 사용하여 프레젠테이션 스타일을 쉽게 지정합니다.

QR 코드

.qr 키워드를 사용하여 프레젠테이션에 QR 코드를 추가하세요.

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

발표자 노트

"발표자 메모"라는 제목의 슬라이드 내용을 따라가면 각 슬라이드에 발표자 메모를 추가할 수도 있습니다. 발표자 보기를 열려면 'p' 키를 누르세요.

매크로 등록

매크로는 슬라이드의 HTML 콘텐츠를 변환하는 데 사용됩니다.

landslide.macro.Macro 파생 클래스를 만들고, process(content, source=None) 메서드를 구현하고, 수정된 내용과

에 추가하려는 일부 CSS 클래스가 포함된 튜플을 반환하여 자신만의 매크로를 등록할 수 있습니다.

요소. 예를 들어:

 !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()

그러면 슬라이드가 아래와 같이 렌더링됩니다.

 !html

  foo
  
    my slide contents
    plop

고급 사용법

사용자 정의 대상 파일 설정

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

디렉토리 작업

 $ landslide slides/

직접 출력 작업

 $ landslide slides.md -o | tidy

대체 산사태 테마 사용

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

Base-64로 인코딩된 이미지 포함

 $ landslide slides.md -i

PDF로 내보내기

 $ landslide slides.md -d presentation.pdf

수학 표기법 활성화

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

$ landslide slides.rst -m

마크다운 확장 활성화

여기에서 사용 가능한 Markdown 확장에 대한 문서를 참조하세요.

 $ landslide slides.md -x abbr

테마

Landslide 테마는 다음과 같은 간단한 구조를 따르는 디렉터리입니다.

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

테마가 HTML 및 JS 파일을 제공하지 않는 경우 기본 테마의 파일이 사용됩니다. CSS는 선택사항이 아닙니다.

마지막으로 --copy-theme 옵션을 landslide 명령에 전달하여 전체 테마 디렉터리를 프레젠테이션 디렉터리에 복사할 수도 있습니다.

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

사용자 스타일시트 및 자바스크립트

자신만의 테마를 만드는 데 방해가 되지 않으려면 생성된 프레젠테이션에 자신의 사용자 CSS 및 js 파일을 포함할 수 있습니다.

이 기능은 css 및/또는 js 플래그를 설정하여 산사태 구성 파일을 사용하는 경우에만 사용할 수 있습니다.

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

이는 프리젠테이션 html 파일의 섹션 내에서 custom.css 스타일시트와 jquery.js 및 powerpoint.js 파일을 모두 연결합니다.

참고: css 및 js 파일의 경로는 landslide 명령을 실행 중인 디렉터리에 상대적이어야 합니다.

프레젠테이션을 온라인에 게시하기

HTML 프리젠테이션을 온라인에 게시하려면 --relative 옵션과 --copy-theme 옵션을 사용하여 프리젠테이션 루트와 관련된 모든 자산 링크를 가져야 합니다.

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

그렇게 하면 전체 프리젠테이션 디렉토리를 웹 서버에 호스팅하기만 하면 됩니다. 물론, 엄청난 프레젠테이션을 호스팅하려면 Python이나 PHP, HTTP 웹 서버(예: Nginx) 외에 다른 어떤 것도 필요하지 않습니다.

테마 변수

base.html 은 다음 템플릿 변수를 활용할 수 있는 Jinja2 템플릿 파일이어야 합니다.

css : 스타일시트 내용, 두 개의 키 print 및 screen 를 통해 사용할 수 있으며 둘 다 다음을 갖습니다.
- 자산 파일 경로에 대한 URL을 저장하는 path_url 키
- 자산 콘텐츠를 저장하는 contents 키
js : 자바스크립트 내용은 다음과 같습니다.
- 자산 파일 경로에 대한 URL을 저장하는 path_url 키
- 자산 콘텐츠를 저장하는 contents 키
slides : 각 슬라이드 목록에는 다음과 같은 속성이 있습니다.
- header : 슬라이드 제목
- content : 슬라이드 내용
- number : 슬라이드 번호
embed : 현재 문서가 독립형 문서입니까?
num_slides : 현재 프레젠테이션의 슬라이드 수
toc : 문서의 섹션을 나열하는 목차입니다. 각 섹션에는 다음과 같은 속성을 사용할 수 있습니다.
- title : 섹션 제목
- number : 해당 섹션의 슬라이드 번호
- sub : 하위 섹션(있는 경우)