跳转到主要内容

Molo是一组以社区为重点的mobi网站发布工具。

项目描述

Molo

Continuous Integration Code Coverage Molo Documentation Pypi Package

安装

Molo需要安装Python(版本2.6或2.7)。此安装方法还需要pip。在遵循下面的安装步骤之前,这两者都必须安装。

安装Molo

然后可以使用以下命令安装Molo:

$ virtualenv ve
$ source ve/bin/activate
(ve)$ pip install molo.core

入门

Molo使用合理的默认值、包和配置为您搭建Django应用程序,帮助您尽快开始。

使用Molo搭建站点

Molo的目的是提供一套经过验证、稳定的包的基础,以帮助Praekelt基金会和合作伙伴实现项目范围。

$ molo scaffold myapp
$ cd myapp/
$ ./manage.py migrate
$ ./manage.py createsuperuser
$ ./manage.py runserver

在您的浏览器中打开示例站点https://127.0.0.1:8000/和CMS https://127.0.0.1:8000/admin/

在现有仓库中搭建站点

并不总是需要为应用程序创建新的目录,尤其是在为已经创建的存储库创建应用程序脚架时。具体来说,Molo 允许为目录提供第二个参数。

在当前目录下构建名为 myapp 的应用程序,请执行以下操作

$ molo scaffold myapp .

指定额外需求

Molo 本身可能不足以满足客户端请求。在构建过程中,使用 --require 命令行参数来包含更多安装所需的库

$ molo scaffold myapp --require=django-contrib-comments

django-contrib-comments 添加到生成的需求文件中,该文件由生成的包的 setup.py 文件读取。

可以在命令行上指定多个需求

$ molo scaffold myapp --require=django-contrib-comments

自动添加已安装的应用程序

如果您包括 Django 应用程序,那么您很可能会希望将其添加到您的 INSTALLED_APPS 设置中,并添加到生成的 urls.py 文件中

$ molo scaffold myapp --include=django_comments ^comments/

这将在以下 urls.py 中产生条目

url(r'^comments/',
    include('django_comments.urls',
            namespace='django_comments',
            app_name='django_comments')),

为了方便,以下是当前插件的完整脚架命令

$ molo scaffold myapp \
    --require=django-contrib-comments --include=django_comments ^comments/ \
    --require=molo.commenting --include=molo.commenting ^commenting/ \
    --require=molo.yourwords --include=molo.yourwords ^yourwords/

Molo、Django 及设置文件

您现在拥有一个标准的 Django 应用程序,用于正常开发,如 Django 文档中概述的那样。唯一的区别是您的设置位于应用程序文件夹中的 settings/dev.pysettings/production.py 文件中的 Python 模块。这两个都继承自 settings/base.py

要创建您自己的自定义设置,在 settings 文件夹中添加一个 local.py 文件。 settings/dev.py 将自动包括这些设置以供您的本地开发环境使用。

从包中解包模板

有时一个包的现有模板可能远远不够,需要一些程度的自定义。在构建的应用程序中使用 unpack-templates 命令来解包包的模板到您的应用程序模板目录中

$ molo scaffold testapp
$ pip install -e testapp
...

您将在 templates 目录中看到 molo.core 随带提供的默认模板

$ ls testapp/testapp/templates
404.html  500.html  base.html core

现在我们将 profiles 模板目录从 molo.profiles 包解包到 testapp 包模板目录中

$ molo unpack-templates molo.profiles testapp
$ ls testapp/testapp/templates
404.html  500.html  base.html core profiles

格式如下

$ molo unpack-templates <source package> <target package>

运行测试

现在开发您的应用程序,并为您添加的功能编写测试。运行 Django 的测试就像您预期的那样

$ ./manage.py test

Molo 中包含什么?

  1. Wagtail CMS

  2. 基本功能电话模板集。

  3. 以下树结构的模型基本模型

    1. 一个站点有语言

    2. 一个语言有一个主页

    3. 文章组织到部分中。

    4. 文章由一个或多个块组成。

    5. 块可以是标题、段落、图像、列表或其他页面的链接。

  4. Molo Profiles:提供代码,帮助在项目中使用 Molo 代码库来处理用户资料。

测试 Molo 脚架工具

如果您有兴趣在或为脚架代码做出贡献,请从 GitHub 存储库 http://github.com/praekelt/molo 克隆此存储库。

安装开发 & 测试依赖项的需求

$ pip install -r requirements-dev.txt

然后使用以下命令运行完整的测试套件

$ py.test

预期拉取请求将遵循 Praekelt 的 工作方式

文档

文档可在网上查阅 http://molo.readthedocs.org/ 以及在存储库的 docs 目录中。

在本地构建文档

$ virtualenv ve
$ source ve/bin/activate
(ve)$ pip install -r requirements-docs.txt
(ve)$ cd docs
(ve)$ make html

您可以在 docs/_build/index.html 找到文档

项目详情


发行历史 发布通知 | RSS订阅

下载文件

下载适用于您平台的文件。如果您不确定选择哪个,请了解更多关于安装包的信息。

源分布

molo.core-11.3.2.tar.gz (6.5 MB 查看哈希值)

上传时间

构建分布

molo.core-11.3.2-py3-none-any.whl (4.7 MB 查看哈希值)

上传时间 Python 3

由以下支持

AWS AWS 云计算和安全赞助商 Datadog Datadog 监控 Fastly Fastly CDN Google Google 下载分析 Microsoft Microsoft PSF赞助商 Pingdom Pingdom 监控 Sentry Sentry 错误日志 StatusPage StatusPage 状态页面