pooneyy

1Panel-Appstore

mirror of https://github.com/pooneyy/1Panel-Appstore

Fork 0

7.3 KiB

Raw Permalink Blame History

Nextcloud 服务器 ☁

一个安全的数据家园。

为什么这么棒？🤩

📁 访问您的数据 您可以将文件、联系人、日历等存储在您选择的服务器上。
🔄 同步您的数据 您可以在各种设备之间同步文件、联系人、日历以及其他内容。
🙌 分享您的数据 …通过给予他人访问您希望他们查看的内容或进行协作的权限。
🚀 支持数百款应用程序 …例如日历、联系人、邮件、视频聊天以及您在我们的应用商店中可以发现的所有其他应用
🔒 安全性 通过我们的加密机制、HackerOne 奖励计划和双因素认证。

您想了解更多关于如何使用 Nextcloud 在家和组织中访问、共享和保护文件、日历、联系人、通信及其他内容的方法吗？[了解更多所有功能]

获取您的 Nextcloud 🚚

☑️ [通过我们的网站或应用程序直接在我们的提供商中注册]
🖥 [自行在您的硬件上安装服务器] 或使用我们的即用型 [设备] 安装
📦 购买一款预装了 Nextcloud 的 awesome device
🏢 找一家为你或你的公司提供 Nextcloud 服务的 service provider

企业用户？公共部门用户或教育用户？你可能想了解一下由 Nextcloud GmbH 提供的 Nextcloud Enterprise。

Get in touch 💬

你也可以获得 Nextcloud 的支持！

加入我们的团队 👪

有很多方式可以贡献，开发只是其中一种！了解更多如何参与，包括作为译者、设计师、测试员，帮助他人，以及其他更多内容！😍

开发环境设置 👩‍💻

🚀 设置本地开发环境
🐛 选择一个合适的初学者问题
👩‍🔧 创建一个分支并进行修改。记得在提交时使用 @0 进行签名
⬆ 创建一个合并请求，并 @mention 提及问题中的审核人员
👍 在审查过程中解决出现的问题
🎉 等待合并！

第三方组件作为 git 子模块处理，因此需要先初始化。除了常规的 git 检出操作外，还需要执行 `git submodule update --init` 或类似命令，详情请参见 Git 文档。

默认包含在常规发布版本中的多个应用程序，如首次运行向导或 Activity，在 master 中缺失，需要手动安装，通过克隆它们到 apps 子文件夹中。

否则，git 检出可以像处理发布存档一样，通过使用 stable* 分支来处理。注意它们永远不应该在生产系统上使用。

前端代码开发 🏗

构建 Vue 组件和脚本

我们越来越多地在前端使用 Vue.js，从设置模块开始。要在代码更改时构建代码，请在根文件夹中使用以下终端命令：

# install dependencies
make dev-setup

# build for development
make build-js

# build for development and watch edits
make watch-js

# build for production with minification
make build-js-production

构建样式

样式用 SCSS 编写，并编译成 css。

# install dependencies
make dev-setup

# compile style sheets
npm run sass

# compile style sheets and watch edits
npm run sass:watch

提交更改

在进行更改时，也要提交编译后的文件！

我们在 Files 和 Settings 中的一些地方仍然使用 Handlebars 模板。我们将逐步用 Vue.js 替换这些模板，但在那之前，你需要单独编译它们。

如果你还没有安装 Handlebars，可以使用这个终端命令进行安装：

sudo npm install -g handlebars

然后在本地 Nextcloud 开发安装的根文件夹中，每次修改了 .handlebars 文件后，都需要在终端中运行以下命令进行编译：

./build/compile-handlebars-templates.sh

在提交 JS 变更之前，请确保也要进行生产构建：

make build-js-production

然后添加编译文件进行提交。

为了节省时间，仅重新构建特定的应用程序，请使用以下命令并用应用程序名称替换模块名称：

MODULE=user_status make build-js-production

请注意，如果您之前使用了 `make build-js` 或 `make watch-js`，会发现很多文件被标记为已更改，因此可能需要先清理工作区。

处理后端代码 🏗

在更改后端 PHP 代码时，通常在提交之前不需要额外的步骤。

然而，如果创建了新文件，您需要运行以下命令以更新自动加载器文件：

build/autoloaderchecker.sh

之后，请确保将自动加载器文件的更改也包含在您的提交中。

我们使用的工具 🛠

👀 BrowserStack 用于跨浏览器测试
🌊 WAVE 用于无障碍测试
🚨 Lighthouse 用于测试性能、无障碍及其他更多内容

GitHub 上的帮助机器人 🤖

在拉取请求中评论 /update-3rdparty 以更新第三方子模块。它将更新为与拉取请求目标同名的第三方分支的最新提交。

贡献指南 📜

从 2016 年 6 月 16 日起，此仓库的所有贡献均视为根据 AGPLv3 或任何后续版本进行许可。

Nextcloud 不需要 Contributor License Agreement (CLA)。版权归属于所有个体贡献者。因此，我们建议如果某文件被大幅修改，每个贡献者在文件头部添加以下行：

@copyright Copyright (c) <year>, <your name> (<your email address>)

请阅读行为准则。该文件为 Nextcloud 参与者提供了一些指导，以确保大家能在积极和鼓舞人心的氛围中有效合作，并解释了我们如何共同努力相互支持和加强。

请审阅贡献指南。

更多关于如何贡献的信息：https://nextcloud.com/contribute/

7.3 KiB Raw Permalink Blame History Unescape Escape