Лекции към курса "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).