Pelican. Установка блога.

[uzverss]

Подготовка зависимостей

Для того чтобы сделать блог, нам понадобиться установить генератор статических сайтов (наш блог будет на Pelican), который будет преобразовывать все текстовые записи в Markdown в статичные HTML страницы. Начнем с подготовки и установим все необходимые зависимости:

#должен быть установлен pip и git
sudo apt-get install python-pip git-core 
# после установки необходимо [настроить git](http://webquant.ru/posts/git/)
#устанавливаем Pelican и Markdown
sudo pip install pelican markdown 
#обновляем pelican до dev версии с github'a
sudo pip install git+https://github.com/getpelican/pelican#egg=pelican --upgrade

Базовая настройка блога pelican

sudo pelican-quickstart
#Ответы на вопросы

Установка новой темы

# переходим в папку с темами
cd /usr/local/lib/python2.7/dist-packages/pelican/themes/
# копируем одну из тем из  
git clone https://github.com/DandyDev/pelican-bootstrap3.git
# смотрим путь до нашей темы 
pelican-themes -l -v 
# устанавливаем тему для сайта
# добавляем переменную THEME=/path/to/my_theme в pelicanconf.py

Создание первого поста в нашем блоге (Pelican)

После настройки проекта создадим первый пост в папке content. Для этого необходимо создать новый файл с расширением *.md (Markdown) следующего содержания:

Title: Pelican. Установка блога.
Date: 2014-10-27 11:59
Category: web
Tags: теги
Slug: pelican
Author: admin
Summary: Пошаговая инструкция по установки блога на Pelican

Мой первый пост для блога на Pelican.

Редактирование статьи

Запустим devserver для редактирования статьи и автоматического обновления сайта в реальном времени:

#запускаем в терминале сервер для генерирования статичных страниц нашего сайта
cd myblog_folder # переходим в папку созданного блога
make devserver # запуск
./develop_server.sh stop # остановка

после запуска локального сервера, можно зайти в браузер и посмотреть его по адресу
http://localhost:8000/

Перенос блога на сервер github

Гитхаб известен тем, что имеет встроенный генератор статических сайтов и к тому же полностью бесплатен, поэтому грех не воспользоваться этим и не установить на его сервере наш блог.

1. Подготовка

• Необходимо ответить "Yes" при создании блога quickstart


• Нужно иметь аккаунт на github


• Должен быть настроен git

2. Создаем репозиторий на github: username.github.io

3. Копируем проект с гитхаба на свой компьютер в папку output своего блога

git clone git@github.com:achicha/achicha.github.io ~/myblog_folder/output

4. работа с git

#переходим в папку, где находяться сгенерированные файлы
cd ~/myblog_folder/output
# инициализируем гит
git init 
# добавляем все файлы в локальный проект нашего блога
git add -A 
# узнаем какие файлы добавлены в проект и в какой ветке (master/slave) работаем
git status 
# добавляем коммит
git commit -a -m “Commit description” 
# отправляем измененные файлы на сервер
git push origin

Настраиваем свое доменное имя

После создания своего блога и запуск его на сервере гитхаба, мне захотелось сделать для него свой домен. Для этого я зарегестрировал доменное имя и иземенил настройки CNAME для сревера:

1. Создаем файл с именем CNAME (пустой, без какого-либо расширения) в папке output


2. Добавляем в него запись своего домена без www, например : mydomain.com


3. Добавляем его на github. Должен измениться домен в username/username.github.io -> settings(снизу в правой боковой колонке) -> github Pages -> your site is published at "your domain"


4. Прописываем "А" запись c IP адресом GitHub'a в DNS настройки у своего провайдера/хостера.


5. Не забыть "А" запись для переадрисации зеркала с "www"

Если не понятно, читаем описание c github

Базовая установка блога, используя генератор статических сайтов Pelican и перенос его на сервер гитхаба, закончена. Далее расширенные настройки Pelican, которые так же очень важны, но не поместились в одну статью.

http://webquant.ru/posts/pelican/