mononcle_menu 0.1.0

mononcle_menu应用程序
==================

Модуль:mononcle_menu

#. Структура папок модуля
#。Конфигурационный файл
#. json файл импорта
#. Публикация через pip3
#. Внесение изменений в модули


**Структура папок модуля**

Модуль представляет собой стандартное приложение для django и включает в себя модели, средства генерации систем управления, шаблоны, статические файлы, а также файлы для интеграции и сборки.
Так как модуль встраивается в одностраничный сайт с помощью сборщика, то у него нет файлов view.py 和 urls.py。Для передачи данных из модуля в основной проект используется файл mioncle.py содеражащий нужные вызовы для определеного моду.
Модули являются частями проекта автоматической сборки одностраничных сайтов на django - https://bitbucket.org/langprism/django-monocle。
Необходимо соблюдать следующие условия наименования файлов и папок。

* monocle_
* 模板
* monocle_
*monocle_.html
* 静态
* monocle_
* 资产
* monocle_.css
* monocle_.js
* 固定装置
*monocle_
[Картинки]
*monocle_,json
* models.py
* admin.py
* monocle.py
* MANIFEST。在
* README.rst
* setup.py
* reqs.txt

**Конфигурационный файл**

Для сборки и интеграции проекта сборщик django-monocle использует файл модуля monocle.py: ::


# название модуля - должно совпадать с
appname = 'monocle_sample'

# модели импортируемые в основное приложение одностраничного проекта
models = ['SampleModel' ]

"""
строка передающая данные из модели в контекст основного шаблона. Этот вызов используется во view.py файле основого приложения проекта при сборке.
"""
context_callback = "'monocle_sample_models': SampleModel.objects.all().filter(isShown= True)"

included_app_reqs = [ ] - зависимости, подключаемые в файле settings.py проекта。

**json файл импорта** Пример
: ::

[
{
“模型”：“monocle_partners.partner”，
“字段”：{
“位置”：0，
“图像”：“monocle_partners/image.jpg”，
“名称”：“Партнер1”，
“isShown”：真
}，
“ pk": 1
},
{
"model": "monocle_partners.partner",
"fields": {
"position": 2,
"image": "monocle_partners/image.jpg",
"name": "Партнер2",
"isShown ": 真
},
"pk":2
}
]

**Публикация через pip3**

Модули устанавливаются сборщиком при помощи менеджера пакетов pip3。Поэтому после внесения изменений в модуль необходимо собрать его в дистрибутив и опубликовать в pipy。
Для этого нужно отредактировать файл setup.py: ::

setup(
name='',
version='0.1.0',
packages=[''],
include_package_data=True,
install_requires=[
"requests",
"bcrypt",
],
license='BSD License', #example license
description='django-monocle 项目的示例应用程序',
long_description=README,
author='Alexander Kalinin @Langprism LTD',
author_email='
classifiers=[
'Environment :: Web Environment',
'Framework :: Django',
'Intended Audience :: Developers',
'License :: OSI Approved :: BSD License', # example license
'Operating System :: OS Independent',
'Programming Language :: Python',
# 如果你卡在 Python 2 上，请适当替换它们。'Programming
Language :: Python :: 3',
'Programming Language :: Python :: 3.2',
'Programming Language :: Python :: 3.3',
'主题 :: Internet :: WWW/HTTP',
'主题 :: Internet :: WWW/HTTP ::动态内容',
],
)

Зависимости пакетов указываются в файле setup.py в атрибуте "install_requires" (см. пример выше)。

После редактирования нужно выполнить команду: ::

python3 setup.py register sdist bdist_wheel upload

Для публикации дистрибутива в индексе нужно ввести данные аккаунта проекта:
логин - monoculus, пароль
- Langprism11

**Внесение изменений в модули**

В случае если модуль необходимо доработать либо внести изменения, необходимо склонировать его с репозитория。Хранилище модулей находится по ссылке https://bitbucket.org/monoculus。
После изменений необходимо снова опубликовать проект pypi, инкрементировать номер версии и выполнить push в репозиторий。