跳转到主要内容

独立、基于Django的带图像支持的粘贴板。

项目描述

xelpaste是一个基于Django的粘贴板,基于dpaste项目。它旨在独立运行,但也可能像常规应用一样安装到现有的Django项目中。

您可以在http://xelpaste.org/找到实时示例。

安装

您可以从您的发行版软件包或通过pip安装此软件

$ pip install xelpaste

安装后,您必须进行配置。最小配置集是[db]部分/etc/xelpaste/config.ini文件(下面提供详细信息)。

配置完成后,您必须准备数据库

$ xelpastectl migrate

这将创建数据库;最后一步是将您的WSGI服务器指向xelpaste.wsgi

配置

Xelpaste将读取所有匹配/etc/xelpaste/*.ini的配置文件。这些是ini风格的文件,定义以下参数

应用程序 ([app])

应用程序的一般行为。

选项

mode

str,应用模式。使用 dev 用于本地开发,否则使用 prod

debug

bool,是否启用调试。有效值: onoff

secret_key

str,在 prod 模式下 必需。Django 安全钩子的密钥

站点 ([site])

托管和 URL。

选项

name

str,您站点的名称(《xelpaste》,《mypaster》,……)。

base_url

str,您的站点托管的位置。必须包含尾部斜杠。

assets_url

str,提供资源的 URL(CSS、JS 等)。可以是相对 URL。

admin_mail

str,管理员应通知的电子邮件。

allowed_hosts

str list,逗号分隔的有效 Host: HTTP 标头列表。有关详细信息,请参阅 Django 文档。

数据库 ([db])

必需;这些定义了片段存储的位置。有效选项包括

engine

str,要选择的引擎。必须是 sqlitemysqlpostgresql 之一;默认为 sqlite

name

str,数据库名称,或 sqlite 的路径。默认为 /var/lib/xelpaste/db.sqlite

host

str,数据库服务器的地址。

port

int,数据库服务器的端口。

user

str,用于连接到数据库服务器的登录名。

password

str,数据库的密码

示例

; A Postgresql configuration; uses default psql port.
[db]
engine = postgresql
name = xelpaste
host = psql42.local
; A sample sqlite configuration.
[db]
engine = sqlite
name = /data/replicated/xelpaste/db.sqlite

片段(《snippets》)

片段行为的选项。

slug_length

int,片段标签的长度。

max_content

size,代码片段的最大大小。有效值包括 10kB2MB 等。

max_file

size,上传的最大大小。有效值包括 10kB2MB 等。

上传(《uploads》)

与私有文件上传相关的选项。

dir

path,上传的存储文件夹。必须由 WSGI 进程可写。

示例: /var/www/xelpaste/uploads

serve

str,文件托管模式。 xelpaste 依赖于 django-sendfile 来提高性能和保护。

有效选项: simplenginxxsendfilemod_wsgi

internal_url

str,django-sendfile 用于托管文件的内部 URL。

支持者