跳转到主要内容

创建用于分享知识的微型博客的应用程序。

项目描述

https://badge.fury.io/py/django-knowledge-share.svg https://travis-ci.org/vintasoftware/django-knowledge-share.svg?branch=master https://codecov.io/gh/vintasoftware/django-knowledge-share/branch/master/graph/badge.svg

用于分享快速知识的微型博客应用程序。此代码为Vinta的运行在http://www.vinta.com.br/lessons-learned/的经验教训课程提供动力。

帖子通过使用自定义命令在Slack中创建,并自动发布到Twitter。

快速入门

安装Django Knowledge Share

pip install django-knowledge-share

为您的微博创建一个应用程序

python manage.py startapp microblog

将其添加到您的 INSTALLED_APPS

INSTALLED_APPS = (
    ...
    "microblog",
    "knowledge_share",
    ...
)

在您的 urls.py 中添加 URL 条目

url(r'^', include('knowledge_share.urls', namespace='microblog')),

在您的 microblog/models.py 中通过继承抽象模型来创建您的模型

# customize those models as needed
from knowledge_share import models as knowledge_share_abstract_models


class MicroBlogPost(knowledge_share_abstract_models.MicroBlogPostBase):
    pass


class MicroBlogCategory(knowledge_share_abstract_models.MicroBlogCategoryBase):
    pass

然后创建并运行您的迁移

python manage.py makemigrations
python manage.py migrate

文档

模型

您可以看到可用的模型及其字段 这里。它们都是抽象的,您需要创建其实例(请参阅快速入门部分)。

Slack 集成

在此页面创建一个自定义命令:https://my.slack.com/services/new/slash-commands

设置 URL 到您的 Slack 终端,默认为 https://yoursite.com/microblog/integrations/slack-slash/。复制生成的令牌并将其添加到 settings.py 作为 “SLACK_TOKEN=’your-token’”。要发送新帖子,请使用 /yourcommand This is a blog post content [Category, Another Category]

Twitter 集成

您需要使用 Twitter 数据设置以下设置

TWITTER_API_KEY
TWITTER_API_SECRET
TWITTER_ACCESS_TOKEN
TWITTER_ACCESS_TOKEN_SECRET

每当创建新帖子时,它将被发布到 Twitter。

模板标签

当您展示帖子内容时,应使用

{% load microblog %}

{{ post.content|convert_to_html }}

如果您想创建一个共享内容的链接,可以使用

{% load microblog %}

<a href="https://twitter.com/intent/tweet?text={{ post|format_post }}">
    Share on twitter
</a>

RSS 订阅

默认情况下,/microblog/feed/ 提供了一个 RSS 订阅。

配置

以下配置可用

# settings.py

# name of the app created with your microblog's models
KNOWLEDGE_APP_NAME = 'microblog'
# the title of the rss feed (available at: /microblog/feed/)
KNOWLEDGE_FEED_TITLE = 'microblog'
# the link of the feed
KNOWLEDGE_FEED_LINK = '/microblog/'
# Either to use twitter or not
KNOWLEDGE_USE_TWITTER = True

运行测试

source <YOURVIRTUALENV>/bin/activate
(myenv) $ pip install tox
(myenv) $ tox

鸣谢

渲染此包所使用的工具

项目详情


下载文件

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

源分布

django-knowledge-share-0.2.0.tar.gz (10.4 kB 查看哈希)

上传时间

由以下机构支持

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