Skip to content

Страница на GitHub Pages#6

Open
nksoff wants to merge 4 commits intomialinx:masterfrom
nksoff:gh-pages
Open

Страница на GitHub Pages#6
nksoff wants to merge 4 commits intomialinx:masterfrom
nksoff:gh-pages

Conversation

@nksoff
Copy link
Copy Markdown
Contributor

@nksoff nksoff commented Nov 28, 2015

Предлагаю сделать страничку на GitHub Pages, на которой будет список уроков, ссылки на них, ссылки на pdf и т.п. Нативно GH Pages поддерживает Jekyll - генератор статики на Ruby. Обычно используют для блогов. В Jekyll шаблонизатор Liquid, похожий на Джанговский.

По структуре:

  • _config.yml - конфиг
  • _layouts - шаблоны для страниц
  • assets - статика (css, js)
  • node_modules - shower
  • pdf - пдфки
  • pictures - картинки к лекциям
  • index.html - главная страница
  • 404.md - страница 404
  • _lessons - папка с уроками (файлики html без хедера, футера, в начале указываются переменные: названия и т.п.)

Нужно будет добавить ветку gh-pages. Тогда страница будет доступна по адресу: http://mialinx.github.io/tp-stepic/ Ветку gh-pages лучше сделать основной, тогда не придется дублировать одно и то же и в master, и gh-pages.
Пока можно посмотреть в http://nksoff.github.io/tp-stepic/

На страницу урока добавил ссылки на следующую/предыдущую страницы и "Web-технологии" - ссылка на главную.

Как локально установить/проверить
Установить jekyll: gem install jekyll
В папке с репозиторием: jekyll serve. По адресу http://localhost:4000/tp-stepic/ будет доступен.
В принципе при этом будут проверяться изменения во всех файлах. Если нужна просто статика, то jekyll build. В папке _site появится статический собранный проект.

Из-за такой привязки к GH Pages пришлось сделать основной URL и URL для статики = /tp-stepic/..., поэтому все ссылки на всех страницах будут начинаться именно так.
Чтобы этого избежать, можно добавлять в параметры команд jekyll --config _config.yml,_config.local.yml, тогда все ссылки будут начинаться с /.

GitHub Pages использует старые версии jekyll (v2.4.0), в нем некоторых фич относительно свежих версий (v3.0.1) нет. О том, как проверять на старых версиях для GH Pages: http://prgssr.ru/documentation/22_github_pages.html

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant