الصفحة الرئيسية>المتعلقة بالبرمجة>شفرة المصدر الأخرى
تنزيل

انهيار أرضي

يقوم Landslide بإنشاء عرض شرائح باستخدام تخفيض السعر أو ReST أو النسيج. إنه مبني على قالب html5slides من Google.

تخفيض السعر التالي ينتج عرض الشرائح هذا. 

 # 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 للنسيج

خياري

  • watchdog للمشاهدة/التجديد التلقائي باستخدام علامة -w
  • الأمير لتصدير قوات الدفاع الشعبي

تثبيت

قم بتثبيت أحدث إصدار ثابت من Landslide باستخدام مدير حزم python مثل pip : 

 $ 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 هو معرّف اللغة المدعوم من pygment باعتباره السطر الأول ذي المسافة البادئة

نص مُعاد هيكلته

  • يجب أن تكون ملفات مصدر ReST ملحقة بـ .rst أو .rest ( .txt غير مدعوم )
  • استخدم العناوين لعناوين الشرائح
  • افصل الشرائح باستخدام قاعدة أفقية ( ---- في RST) باستثناء نهاية ملفات RST

النسيج

  • افصل بين الشرائح باستخدام --- ، تمامًا كما هو الحال في تخفيض السعر

التقديم

  • قم بتشغيل landslide slides.md أو landslide slides.rst
  • استمتع presentation.html الذي تم إنشاؤه حديثًا

أو احصل عليه كمستند PDF إذا كان Prince مثبتًا ومتاحًا على نظامك: 

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

المشاهدة

  • اضغط على h لتبديل عرض المساعدة
  • اضغط على left arrow right arrow للتنقل
  • اضغط على t لتبديل جدول محتويات العرض التقديمي الخاص بك. عناوين الشرائح هي روابط
  • اضغط على ESC لعرض نظرة عامة على العرض التقديمي (Exposé)
  • اضغط على n لتبديل رؤية رقم الشريحة
  • اضغط على b لتبديل إفراغ الشاشة
  • اضغط على c لتبديل سياق الشريحة الحالية (الشرائح السابقة والتالية)
  • اضغط على e لإنشاء شرائح تملأ المساحة المتوفرة بالكامل داخل نص المستند
  • اضغط على S لتبديل عرض الرابط إلى الملف المصدر لكل شريحة
  • اضغط على "2" لتبديل الملاحظات في الشرائح الخاصة بك (حدد ذلك باستخدام ماكرو .notes)
  • اضغط على "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: 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

تضمين الصور المشفرة بقاعدة 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 الخاصة بك في العرض التقديمي الذي تم إنشاؤه.

هذه الميزة متاحة فقط إذا كنت تستخدم ملف تكوين Landlide، وذلك عن طريق تعيين علامتي css و/أو js : 

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

سيؤدي ذلك إلى ربط ورقة أنماط custom.css وكل من ملفات jquery.js و powerpoint.js ضمن قسم في ملف html للعرض التقديمي.

ملاحظة: يجب أن تكون المسارات إلى ملفات css وjs مرتبطة بالدليل الذي تقوم بتشغيل الأمر landslide منه.

نشر العرض التقديمي الخاص بك على الانترنت

إذا كنت تنوي نشر عرض HTML التقديمي الخاص بك عبر الإنترنت، فسيتعين عليك استخدام الخيار --relative ، بالإضافة إلى خيار --copy-theme للحصول على جميع روابط الأصول المتعلقة بجذر العرض التقديمي الخاص بك؛ 

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

بهذه الطريقة، سيكون عليك فقط استضافة دليل العرض التقديمي بالكامل على خادم ويب. بالطبع، لا يلزم استخدام Python أو PHP أو أي شيء آخر غير خادم الويب HTTP (مثل Nginx) لاستضافة عرض تقديمي ساحق.

متغيرات الموضوع

يجب أن يكون ملف base.html عبارة عن ملف قالب Jinja2 حيث يمكنك الاستفادة من متغيرات القالب التالية:

  • css : محتويات ورقة الأنماط، وهي متاحة عبر مفتاحين، print screen ، وكلاهما يحتوي على:
    • مفتاح path_url يخزن عنوان URL لمسار ملف الأصل
    • مفتاح contents يقوم بتخزين محتويات الأصول
  • js : محتويات جافا سكريبت، والتي تحتوي على:
    • مفتاح path_url يخزن عنوان URL لمسار ملف الأصل
    • مفتاح contents يقوم بتخزين محتويات الأصول
  • slides : قائمة الشرائح، ولكل منها الخصائص التالية:
    • header : عنوان الشريحة
    • content : محتويات الشريحة
    • number : رقم الشريحة
  • embed : هل المستند الحالي مستند مستقل؟
  • num_slides : عدد الشرائح في العرض التقديمي الحالي
  • toc : جدول المحتويات، مع إدراج أقسام المستند. يتوفر في كل قسم هذه الخصائص:
    • title : عنوان القسم
    • number : رقم شريحة القسم
    • sub : الأقسام الفرعية، إن وجدت

نطاق الأنماط

  • لتغيير أنماط عرض HTML5، قم بتعديل ورقة أنماط css/screen.css المجمعة مع القالب الذي تستخدمه
  • بالنسبة لملف PDF، قم بتعديل ملف css/print.css

المؤلفون

المؤلف الأصلي وقائد التطوير

مؤلف مشارك

المساهمين

راجع https://github.com/adamzap/landslide/contributors

مؤلفو القالب الأساسي والمساهمون (شرائح html5)

يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل