阿姆斯特朗是一个为新闻机构设计的开源发布系统,它为您的团队提供了在媒体丰富的环境中进行报道所需的技术优势。
armstrong的Python项目详细描述
armstrong是一个为新闻机构设计的开源发布系统,它为您的团队提供了在媒体丰富的环境中进行报告所需的技术优势。
属于
阿姆斯特朗。安装此软件包是获得Armstrong的完整
发行版的最简单方法,但不需要使用
Armstrong的各种组件。
使用"pip"从
"pypi"安装它,如下所示::
$pip install armstrong
最新版本是"11.09.0.alpha.1"。这是*alpha*软件,所以在开发时请记住这一点。当我们在alpha中尽一切努力保持发行版之间的向后兼容性时,事情可能会以破坏代码的方式发生变化。
我们强烈建议在创建虚拟环境时使用`--distribute``标志,因为这是我们用于测试的。您使用传统设置工具的结果可能会有所不同。
通过访问我们的"github"页面并
克隆或下载tarball获取最新版本。
一旦获得,切换到存储库的目录(或快照,如果下载了
tarball)并告诉pip安装它::
$git clone git://github.com/armstrong/armstrong.git
…git的几行输出…
$cd armstrong
$pip安装。
创建一个像这样的新项目:
$armstrong init mysite
armstrong initialized!
您可以使用`--template=demo``参数初始化一个项目,以便使用已设置的demo sqlite3数据库进行初始化。这提供了一个如何使用armstrong的工作示例。
armstrong项目结构
||-开发。txt
`-project.txt
~settings/
124;-默认值.py
||-development.py
`-production.py
-wsgi.py
``settings`目录包含您的django设置。
``settings.defaults``模块包含环境中常见的所有基本设置。`` settings.development``具有特定于
开发环境的设置,而'settings.production``包含所有
生产设置。
您需要编辑"settings.development"和"settings.production"来配置要使用的数据库引擎。
盒子。您不应该将这些文件包含在
存储库中--应该共享的任何文件都应该放在相应的
设置模块中。
``settings.development``和``settings.production``将您的
``root`urlconf``配置为'`url.development``或'`url.production`,
分别。与它们的"settings.*"对应项一样,您可以将它们用于
enviro将所有默认值存储在
``urls.defaults`.
作为参数提供给"pip install-r"。`` development.txt ``应该包含您的开发环境的所有
需求,并包含``project.txt``。
` project.txt ``文件应该包含您的``have`
对项目的所有需求。
将``templates``目录配置为你的项目是
模板。它包含一个简单的"index.html",在请求
`/``时加载,这样您就可以验证所有设置是否正确。
``wsgi.py``文件为运行项目提供了一个基本的wsgi模块。它的
配置为使用"settings.development"设置运行,因此在运行到生产环境之前必须对其进行
调整。
*注意*:不必使用阿姆斯特朗项目布局。您可以在现有的django项目中利用
armstrong的所有组件。这里的
只是帮助您开始。
您需要安装需求文件,因为有些包需要从github安装
armstrong所依赖的包。
::
$cd mysite
$pip install-r requirements/project.txt
根据需求,最后一步是创建数据库。运行"armstrong
syncdb",根据
"已安装的应用程序"设置中列出的应用程序初始化数据库。运行之后,Django将创建一个数据库
(有关"syncdb"的更多信息,请参阅"Django文档"。
_ django docs:https://docs.django project.com/en/1.3/ref/django-admin/django-admin-syncdb
最后,既然已经安装了所有依赖项,并且有了一个
数据库,那么可以通过在项目内部运行"armstrong runserver"来测试所有内容。默认情况下,它监听端口上的"localhost"
"8000"。把它装上去,要么就是"欢迎来到阿姆斯特朗!"``
页面或演示站点,具体取决于调用"armstrong init"时是否使用了`--template=demo``
标志。
现在,您已经准备好开始在armstrong上开发了。
versions
--
armstrong将基于日期的版本用于这个主要的"armstrong"包。当前版本是"11.09.0.alpha.1"。有关如何在armstrong中处理
版本的更多信息,请参见wiki上的"版本"页面。
…_版本:https://github.com/armstrong/armstrong/wiki/versions
changelog
----
``12.03.0`
这会将各种包更新为其当前的稳定版本。
*django 1.4支持*
armstrong现在支持django 1.4,并已维护向后
与django 1.3.1兼容。
*armstrong wells*
wells现在支持allow empty wells(必须明确选择
新样式)。提供用于创建自定义井模型的抽象模型,并允许在管理员中进行复制。
*阿姆斯特朗部分*
部分经历了许多小的改进。他们现在有了一个更好的管理,更友好的信号,并且只支持显示已发布的项目。
*armstrong布局*
`utils.render_model``功能现在拥有可配置的后端,因此您可以自定义模型ar的方式。e呈现。
*相关内容*
**向后不兼容的更改**:
字段的内部表示已更改,以更好地反映它们应该执行的操作。
`armstrong.apps.related\u content readme`中提供了所有更改的完整说明。此新代码不需要数据库迁移。_ armstrong.apps.related廑content:https://github.com/armstrong/armstrong.apps.related廑content/廑readme
``11.12.0`
这会将各种包更新为当前版本。
*armstrong hatband*
我们已经更新了hatband内部的wells接口,使其成为更多
可访问。
*armstrong images*
我们现在包括一个"imageset",用于处理您可能已经猜到的"imageset"模型集。感谢@pizzapather在
令人垂涎欲滴的媒体上的贡献。
*改进了相关内容*
我们添加了更好的相关内容处理,一个新的管理员,以及新的
helper字段,用于处理相关内容的两边
关系。
*armstrong cli*
我们删除了`--demo``标志,取而代之的是`--template=demo`
转发。
``11.09.0`
这会将各种包更新为当前版本。此外,
它在
混音中添加了"armstrong.hatband"和"armstrong.core.arm廑layout"。
*armstrong hatband*
每一顶好帽子都需要一个hatband。阿姆斯壮的HAtBand应用程序是我们增强Django内置管理界面的
基础。但有几件事值得特别指出。
*与visualearch的集成*
Wells现在有了一个更好的用户界面,感谢"visualearch"。这个新的
用户界面允许您在
将新的"节点"附加到"井"时快速搜索所有模型。
*富文本编辑器*
我们添加了一个新的"富文本小部件",允许您轻松配置富文本您可以选择编辑器,并让所有
管理字段跨armstrong切换到使用它。我们提供内置"ckeditor"支持的
。
*新的演示数据*
现在您可以在"armstrong init"中包含"demo"参数以使用我们的演示数据库。这包括lorem ipsum文章和一些
默认部分。
*新的布局代码*
``armstrong.core.arm\u layout``引入了`{%render\u model%}``
模板标记,用于切换用于渲染
模型的模板。
*向后不兼容的更改*
*``armstrong.core.arm戋wells``已将其所有显示逻辑移到
新的``armstrong.core.arm戋layout``应用程序。
*我们已从``contentbase``中删除了``primary戋section```释放阿姆斯特朗。这是一个不稳定的,
开发人员预览。
主"armstrong"`
包单独安装这些程序,每个程序都固定到特定的
点发布版。
11.09版本中包含以下组件:
``armstrong.cli`
用于创建和使用armstrong的命令行工具环境。
您可以在Armstrong环境中使用它来替代Django中的传统"manage.py"。
有关详细信息,请参见"armstrong.cli"存储库。
`"armstrong.core.arm"内容包含阿姆斯特朗风格的内容。这不是
提供模型的任何具体实现,而不是包含较低级别的功能:字段、mixin,以及用于创建共享内容模型的基``content base`.
有关详细信息,请参见"armstrong.core.arm_content`"存储库。
``armstrong.core.arm_layout``
包含用于在其当前
上下文中管理数据显示的帮助程序布局。
有关详细信息,请参阅"armstrong.core.arm_layout"存储库。
``armstrong.core.arm_sections`
提供了一个将模型结构化为"sections"的系统,以便在
网站上用于组织目的。
` armstrong.core.arm_sections``存储库了解更多信息。
``armstrong.core.arm_wells`
与将内容"固定"到特定区域相关的功能。wells
使您能够指定任何模型集合及其顺序,以便在整个站点的不同位置显示。
有关详细信息,请参见"armstrong.core.arm_wells"存储库。
``armstrong.apps.articles`
处理基本物品。这在"arm内容"组件中找到的特定于文章的特性之上提供了一个薄层。但是可以满足许多编辑室的需要,只需满足一些简单的要求。
有关详细信息,请参阅"armstrong.apps.articles"存储库。
``armstrong.apps.content`
提供其他django应用程序可以使用的具体"content"模型的简单应用程序构建。
有关详细信息,请参阅"armstrong.apps.content"存储库。
``armstrong.hatband``
armstrong增强版的django内置的"django.contrib.admin`
应用程序。
有关详细信息,请参阅"armstrong.hatband"存储库。信息。
有助于找到要更改的阿姆斯特朗组件。很少有人需要从修改armstrong主存储库开始。
*创建一些很棒的东西——使代码更好,添加一些功能,
无论如何(这是最困难的部分)。
*"fork-it"
*创建一个主题分支来容纳您的更改
*在新主题分支中获取所有提交
*提交一个"pull-request"
。_分叉:http://help.github.com/forking/
…_拉取请求:http://help.github.com/pull-requests/
state of project
----
armstrong是一个开源的新闻平台,任何
组织都可以免费使用。这是"德克萨斯论坛报"与"湾公民"合作的结果,也是John S.和James L. Knight《BR/>基金会》授予的。< BR> > BR/>跟随发展,一定要加入"谷歌集团"。_海湾市民:http://www.baycizent.org/
。约翰·S·杰姆斯·L·奈特基金会:http://www. koundoundound.org/br/>_德克萨斯论坛报:http://www.texas tribune.org/
。_谷歌集团:http://groups.google.com/group/armstrongcms
。_ PIP:http://www.pip-installer.org/
。_ pypi:http://pypi.python.org/pypi
。_ github:http://github.com/armstrong/armstrong/
。_ armstrong.cli:http://github.com/armstrong/armstrong.cli
。_ armstrong.core.arm_内容:http://github.com/armstrong/armstrong.core.arm_content
…_ armstrong.core.arm_布局:http://github.com/armstrong/armstrong.core.arm_布局
…_ armstrong.core.arm_部分:http://github.com/armstrong/armstrong.core.arm_部分
…_ armstrong.core.arm_wells:http://github.com/armstrong/armstrong.core.arm_wells
。_ armstrong.apps.articles:http://github.com/armstrong/armstrong.apps.articles
_ armstrong.apps.content:http://github.com/armstrong/armstrong.apps.content
。_ armstrong.apps.events:http://github.com/armstrong/armstrong.apps.events
。u armstrong.hatband:http://github.com/armstrong/armstrong.hatband
。编辑:http://ckeditor.com/
…virtualenv:http://www.virtualenv.org/en/latest/index.html
。visualearch:http://documentcloud.github.com/visualearch/
。分发:http://pypi.python.org/pypi/distribute
属于
阿姆斯特朗。安装此软件包是获得Armstrong的完整
发行版的最简单方法,但不需要使用
Armstrong的各种组件。
使用"pip"从
"pypi"安装它,如下所示::
$pip install armstrong
最新版本是"11.09.0.alpha.1"。这是*alpha*软件,所以在开发时请记住这一点。当我们在alpha中尽一切努力保持发行版之间的向后兼容性时,事情可能会以破坏代码的方式发生变化。
我们强烈建议在创建虚拟环境时使用`--distribute``标志,因为这是我们用于测试的。您使用传统设置工具的结果可能会有所不同。
通过访问我们的"github"页面并
克隆或下载tarball获取最新版本。
一旦获得,切换到存储库的目录(或快照,如果下载了
tarball)并告诉pip安装它::
$git clone git://github.com/armstrong/armstrong.git
…git的几行输出…
$cd armstrong
$pip安装。
创建一个像这样的新项目:
$armstrong init mysite
armstrong initialized!
您可以使用`--template=demo``参数初始化一个项目,以便使用已设置的demo sqlite3数据库进行初始化。这提供了一个如何使用armstrong的工作示例。
armstrong项目结构
||-开发。txt
`-project.txt
~settings/
124;-默认值.py
||-development.py
`-production.py
-wsgi.py
``settings`目录包含您的django设置。
``settings.defaults``模块包含环境中常见的所有基本设置。`` settings.development``具有特定于
开发环境的设置,而'settings.production``包含所有
生产设置。
您需要编辑"settings.development"和"settings.production"来配置要使用的数据库引擎。
盒子。您不应该将这些文件包含在
存储库中--应该共享的任何文件都应该放在相应的
设置模块中。
``settings.development``和``settings.production``将您的
``root`urlconf``配置为'`url.development``或'`url.production`,
分别。与它们的"settings.*"对应项一样,您可以将它们用于
enviro将所有默认值存储在
``urls.defaults`.
需求,并包含``project.txt``。
` project.txt ``文件应该包含您的``have`
对项目的所有需求。
将``templates``目录配置为你的项目是
模板。它包含一个简单的"index.html",在请求
`/``时加载,这样您就可以验证所有设置是否正确。
``wsgi.py``文件为运行项目提供了一个基本的wsgi模块。它的
配置为使用"settings.development"设置运行,因此在运行到生产环境之前必须对其进行
调整。
*注意*:不必使用阿姆斯特朗项目布局。您可以在现有的django项目中利用
armstrong的所有组件。这里的
只是帮助您开始。
您需要安装需求文件,因为有些包需要从github安装
armstrong所依赖的包。
::
$cd mysite
$pip install-r requirements/project.txt
根据需求,最后一步是创建数据库。运行"armstrong
syncdb",根据
"已安装的应用程序"设置中列出的应用程序初始化数据库。运行之后,Django将创建一个数据库
(有关"syncdb"的更多信息,请参阅"Django文档"。
_ django docs:https://docs.django project.com/en/1.3/ref/django-admin/django-admin-syncdb
最后,既然已经安装了所有依赖项,并且有了一个
数据库,那么可以通过在项目内部运行"armstrong runserver"来测试所有内容。默认情况下,它监听端口上的"localhost"
"8000"。把它装上去,要么就是"欢迎来到阿姆斯特朗!"``
页面或演示站点,具体取决于调用"armstrong init"时是否使用了`--template=demo``
标志。
现在,您已经准备好开始在armstrong上开发了。
versions
--
armstrong将基于日期的版本用于这个主要的"armstrong"包。当前版本是"11.09.0.alpha.1"。有关如何在armstrong中处理
版本的更多信息,请参见wiki上的"版本"页面。
…_版本:https://github.com/armstrong/armstrong/wiki/versions
changelog
----
``12.03.0`
这会将各种包更新为其当前的稳定版本。
*django 1.4支持*
armstrong现在支持django 1.4,并已维护向后
与django 1.3.1兼容。
*armstrong wells*
wells现在支持allow empty wells(必须明确选择
新样式)。提供用于创建自定义井模型的抽象模型,并允许在管理员中进行复制。
*阿姆斯特朗部分*
部分经历了许多小的改进。他们现在有了一个更好的管理,更友好的信号,并且只支持显示已发布的项目。
*armstrong布局*
`utils.render_model``功能现在拥有可配置的后端,因此您可以自定义模型ar的方式。e呈现。
*相关内容*
**向后不兼容的更改**:
字段的内部表示已更改,以更好地反映它们应该执行的操作。
`armstrong.apps.related\u content readme`中提供了所有更改的完整说明。此新代码不需要数据库迁移。_ armstrong.apps.related廑content:https://github.com/armstrong/armstrong.apps.related廑content/廑readme
``11.12.0`
这会将各种包更新为当前版本。
*armstrong hatband*
我们已经更新了hatband内部的wells接口,使其成为更多
可访问。
*armstrong images*
我们现在包括一个"imageset",用于处理您可能已经猜到的"imageset"模型集。感谢@pizzapather在
令人垂涎欲滴的媒体上的贡献。
*改进了相关内容*
我们添加了更好的相关内容处理,一个新的管理员,以及新的
helper字段,用于处理相关内容的两边
关系。
*armstrong cli*
我们删除了`--demo``标志,取而代之的是`--template=demo`
转发。
``11.09.0`
这会将各种包更新为当前版本。此外,
它在
混音中添加了"armstrong.hatband"和"armstrong.core.arm廑layout"。
*armstrong hatband*
每一顶好帽子都需要一个hatband。阿姆斯壮的HAtBand应用程序是我们增强Django内置管理界面的
基础。但有几件事值得特别指出。
*与visualearch的集成*
Wells现在有了一个更好的用户界面,感谢"visualearch"。这个新的
用户界面允许您在
将新的"节点"附加到"井"时快速搜索所有模型。
*富文本编辑器*
我们添加了一个新的"富文本小部件",允许您轻松配置富文本您可以选择编辑器,并让所有
管理字段跨armstrong切换到使用它。我们提供内置"ckeditor"支持的
。
*新的演示数据*
现在您可以在"armstrong init"中包含"demo"参数以使用我们的演示数据库。这包括lorem ipsum文章和一些
默认部分。
*新的布局代码*
``armstrong.core.arm\u layout``引入了`{%render\u model%}``
模板标记,用于切换用于渲染
模型的模板。
*向后不兼容的更改*
*``armstrong.core.arm戋wells``已将其所有显示逻辑移到
新的``armstrong.core.arm戋layout``应用程序。
*我们已从``contentbase``中删除了``primary戋section```释放阿姆斯特朗。这是一个不稳定的,
开发人员预览。
主"armstrong"`
包单独安装这些程序,每个程序都固定到特定的
点发布版。
11.09版本中包含以下组件:
``armstrong.cli`
用于创建和使用armstrong的命令行工具环境。
您可以在Armstrong环境中使用它来替代Django中的传统"manage.py"。
有关详细信息,请参见"armstrong.cli"存储库。
`"armstrong.core.arm"内容包含阿姆斯特朗风格的内容。这不是
提供模型的任何具体实现,而不是包含较低级别的功能:字段、mixin,以及用于创建共享内容模型的基``content base`.
有关详细信息,请参见"armstrong.core.arm_content`"存储库。
``armstrong.core.arm_layout``
包含用于在其当前
上下文中管理数据显示的帮助程序布局。
有关详细信息,请参阅"armstrong.core.arm_layout"存储库。
``armstrong.core.arm_sections`
提供了一个将模型结构化为"sections"的系统,以便在
网站上用于组织目的。
` armstrong.core.arm_sections``存储库了解更多信息。
``armstrong.core.arm_wells`
与将内容"固定"到特定区域相关的功能。wells
使您能够指定任何模型集合及其顺序,以便在整个站点的不同位置显示。
有关详细信息,请参见"armstrong.core.arm_wells"存储库。
``armstrong.apps.articles`
处理基本物品。这在"arm内容"组件中找到的特定于文章的特性之上提供了一个薄层。但是可以满足许多编辑室的需要,只需满足一些简单的要求。
有关详细信息,请参阅"armstrong.apps.articles"存储库。
``armstrong.apps.content`
提供其他django应用程序可以使用的具体"content"模型的简单应用程序构建。
有关详细信息,请参阅"armstrong.apps.content"存储库。
``armstrong.hatband``
armstrong增强版的django内置的"django.contrib.admin`
应用程序。
有关详细信息,请参阅"armstrong.hatband"存储库。信息。
有助于找到要更改的阿姆斯特朗组件。很少有人需要从修改armstrong主存储库开始。
*创建一些很棒的东西——使代码更好,添加一些功能,
无论如何(这是最困难的部分)。
*"fork-it"
*创建一个主题分支来容纳您的更改
*在新主题分支中获取所有提交
*提交一个"pull-request"
。_分叉:http://help.github.com/forking/
…_拉取请求:http://help.github.com/pull-requests/
state of project
----
armstrong是一个开源的新闻平台,任何
组织都可以免费使用。这是"德克萨斯论坛报"与"湾公民"合作的结果,也是John S.和James L. Knight《BR/>基金会》授予的。< BR> > BR/>跟随发展,一定要加入"谷歌集团"。_海湾市民:http://www.baycizent.org/
。约翰·S·杰姆斯·L·奈特基金会:http://www. koundoundound.org/br/>_德克萨斯论坛报:http://www.texas tribune.org/
。_谷歌集团:http://groups.google.com/group/armstrongcms
。_ PIP:http://www.pip-installer.org/
。_ pypi:http://pypi.python.org/pypi
。_ github:http://github.com/armstrong/armstrong/
。_ armstrong.cli:http://github.com/armstrong/armstrong.cli
。_ armstrong.core.arm_内容:http://github.com/armstrong/armstrong.core.arm_content
…_ armstrong.core.arm_布局:http://github.com/armstrong/armstrong.core.arm_布局
…_ armstrong.core.arm_部分:http://github.com/armstrong/armstrong.core.arm_部分
…_ armstrong.core.arm_wells:http://github.com/armstrong/armstrong.core.arm_wells
。_ armstrong.apps.articles:http://github.com/armstrong/armstrong.apps.articles
_ armstrong.apps.content:http://github.com/armstrong/armstrong.apps.content
。_ armstrong.apps.events:http://github.com/armstrong/armstrong.apps.events
。u armstrong.hatband:http://github.com/armstrong/armstrong.hatband
。编辑:http://ckeditor.com/
…virtualenv:http://www.virtualenv.org/en/latest/index.html
。visualearch:http://documentcloud.github.com/visualearch/
。分发:http://pypi.python.org/pypi/distribute