ekalinin / nodeguide.ru

nodeguide.ru

Что это

Это исходный код, отвечающий за работу сайта http://nodeguide.ru.

Как это работает

Внутри работают два фреймворка:

• sphinx.pocoo.org (обертка над reStructuredText)
• express (веб фреймворк для node.js)

Первый отвечает за трансляцию исходных текстов из *.rst в *.json. Второй — за отображение json в HTML.

Локальный запуск

Для того, чтобы заставить работать этот код на локальной машине необходимо выполнить описанные ниже манипуляции. Все действия рассчитаны на то, что будут выполняться в ОС типа Ubuntu/Debian.

Чтобы не засорять систему пакетами, которые, возможно больше нигде и не понадобятся, а так же для случаев, если нет прав root, вся установка будет выполняться в изолированных виртуальных окружениях (отдельно для python, отдельно для node.js).

Чтобы иметь возможность собрать node.js необходимо установить следующие пакеты:

$ sudo aptitude install build-essential libssl-dev

Чтобы иметь возможность создавать изолированные окружения, необходимо установить следующие пакеты:

$ sudo aptitude install curl python-virtualenv

Создаем виртуальное окружение для python и активируем его:

$ virtualenv --no-site-packages ./env
$ . ./env/bin/activate

Устанавливаем пакеты в python-окружении. sphinx — для генерации *.json, nodeenv — для создания виртуального окружения для node.js:

(env) $ pip install nodeenv sphinx

Создаем виртуальное окружение для node.js, попутно устанавливая все необходимые пакеты для node.js, и активируем новое окружение:

(env) $ nodeenv --node=7.8.0 --prebuilt -p
(env) $ npm install

Генерируем *.json и запускаем сайт на http://127.0.0.1:3000:

(env) $ make dev