Skip to content

Latest commit

 

History

History
47 lines (30 loc) · 3.28 KB

README.markdown

File metadata and controls

47 lines (30 loc) · 3.28 KB

Лекции към курса "WWW Технологии"

Лекциите са форкнати от курса "Програмиране с Ruby", издание 2012/2013.

Презентациите се пишат на Slim с няколко разширения, специфични за нашия начин на употреба.

Съдържанието на презентациите се намира в папка lectures/. Всяка презентация се описва с няколко реда в lectures/index.yml.

На база на данните в lectures/, се генерират статичните HTML-версии на презентациите, които след генерация живеят в папка compiled/. Те са крайният продукт, който се качва някъде.

Инсталация

  • Инсталирайте Ruby 1.9.3-p448
  • Клонирате хранилището някъде и сменате текущата си директория да е там
  • sudo apt-get install python-setuptools
  • sudo easy_install pygments
  • gem install bundler
  • bundle install
  • bundle exec thor rebuild

Генериране на една лекция

С командата thor lecture <index> може да прегенерирате лекция номер <index>. Например, ако искате да прегенерирате презентация 8, това става със следната команда:

bundle exec thor lecture 8

Възможно е и да изпълните thor watch. Това ще стартира процес, който да стои и да слуша за промени по файловете в папката lectures/ и ще прегенерира съответната лекция автоматично при промяна на който и да е от .slimsource-файловете. След като я прегенерира, ще рестартира автоматично браузъра, за да може промените да бъдат видяни веднага.

Syntax highlighting

Може да използвате syntax highlighting, за примерите, като посочите езика в lang таг. Пример:

  example:
    [lang:php]
    <?php //... ?>

  example:
    [lang:javascript]
    alert('boo');

Упътвания за принос

За да допринесете по някакъв начин към тези материали, е необходимо първо да си подкарате локално генерацията на слайдовете, след това да генерирате HTML-версията на презентацията след промените и да я прегледате в браузър, за да се уверите, че промените изглеждат така, както сте очаквали.

Препоръчително е да правите pull request-и в съответен branch, например 08-fix-typos (за поправка на правописни грешки в презентация 8).