# nodeguide.ru

**Repository Path**: mirrors_ekalinin/nodeguide.ru

## Basic Information

- **Project Name**: nodeguide.ru
- **Description**: nodeguide.ru
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-11-23
- **Last Updated**: 2026-04-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

Что это
=======

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

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

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

* sphinx.pocoo.org_ (обертка над reStructuredText_)
* express_ (веб фреймворк для node.js_)

.. _sphinx.pocoo.org: http://sphinx.pocoo.org/
.. _express: http://expressjs.com
.. _node.js: http://nodejs.org/
.. _reStructuredText: http://docutils.sf.net/rst.html

Первый отвечает за трансляцию исходных текстов из \*.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

.. _sphinx: http://sphinx.pocoo.org/
.. _nodeenv: http://github.com/ekalinin/nodeenv

Создаем виртуальное окружение для 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