一緒に書く習慣を身につけましょう!「ナゲッツデイリーニュープラン・4月アップデートチャレンジ」に参加して5日目です。クリックしてイベントの詳細をご覧ください。
私のように、自分で建てたものをインターネット上の「私有地」と私有地だと思っている人がいるかどうかはわかりません。自分の土地の3分の1を所有することには一種の喜びがあります。
たとえば、自作のブログは好きなエッセイを書くことができ、読者を喜ばせることなく自分を楽しませることができます。別の例は、自分が知らない知識のポイントを心配することなく直接記録できる自作のwikiです。低レベルで笑われることについて。共同構築を除けば、Wikiはブログのカジュアルな性質とは異なり、記録されたコンテンツは、独自の知識ネットワークを構築するために使用できる知識ポイントと分類にさらに注意を払っています。
ブログを「日記」と比較すると、ウィキは「ノート」であり、知識ポイントの記録に使用されるため、閲覧や更新に便利です。明確なディレクトリがあり、知識ポイントを関連付けることもできます。他の知識のポイントは、徐々に「百科事典」に拡大します。「本全体」。
1.はじめに
知識は蓄積にあり、私たちは櫛を梳くことを忘れてはなりません。
今日、私たちが紹介するオープンソースプロジェクトはwiki.jsです。これは、wikiプラットフォームを構築し、知識ポイントを整理するために特別に使用されます。
これは、コメント、マークダウンエディター、画像アップロード、タグ、グローバル検索、協調編集、編集履歴、ユーザー管理、Google Analyticsなどの機能を備えた、軽量で強力なwikiオープンソースプロジェクトであり、高度なカスタマイズをサポートします。
使用されるテクノロジースタックも、Node.js、PostgreSQL、Vue.js、Dockerなどのテクノロジーを使用する古いwikiシステムとは異なります。Dockerに基づくワンクリックデプロイメントはWordPressに非常に似ていますが、クールすぎないでください。
重要なのは中国語をサポートすることであり、インターフェースはシンプルで美しく、多くの同様のプロジェクトから際立たせるのに十分です。
これを見るとかゆみを感じますか?それを実行させるために私と一緒に来てください!
2.インストール
オープンソースプロジェクトを成功させるために必要な要素の1つは、詳細で理解しやすいドキュメントを用意することであり、インストール手順は最優先事項です。
Wiki.js 官方文档提供了多种部署方法,包括:Linux、macOS、Windows、Docker、k8s 等,涵盖了几乎所有可能性,十分全面。
下面我就介绍其中最快捷和通用的一种,即基于 Docker 的 Docker Compose 部署。
Tips:如果你不懂 Docker 建议跟着这里逐步执行
下面我将主要介绍 Linux 下的安装步骤,其它系统有桌面版不再赘述。
如果你机器上有 Docker 仅需两步即可完成安装。
第一步,安装 docker-compose:
1、下载
curl -L https://get.daocloud.io/docker/compose/releases/download/v2.4.1/docker-compose-`uname -s`-`uname -m` > /usr/local/bin/docker-compose
复制代码
2、加执行权限
$ sudo chmod +x /usr/local/bin/docker-compose
复制代码
3、创建快捷方式
$ sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose
复制代码
至此,你就可以在任何地方使用 docker-compose
命令了。
第二步,运行 docker-compose:
1、创建配置文件 docker-compose.yml
内容如下:
整个项目分为 数据库 和 项目代码 两部分,与之对应的是 pg 容器
和 wiki 容器
。
version: "3"
services:
db:
container_name: pg
image: postgres:11-alpine
environment:
POSTGRES_DB: wiki
POSTGRES_PASSWORD: wikijsrocks
POSTGRES_USER: wikijs
logging:
driver: "none"
restart: unless-stopped
volumes:
- db-data:/var/lib/postgresql/data
wiki:
container_name: wiki
image: ghcr.io/requarks/wiki:2
depends_on:
- db
environment:
DB_TYPE: postgres
DB_HOST: db
DB_PORT: 5432
DB_USER: wikijs
DB_PASS: wikijsrocks
DB_NAME: wiki
restart: unless-stopped
ports:
- "8001:3000"
volumes:
db-data:
复制代码
2、在配置所在的目录下,执行命令:
- 运行:
docker-compose up -d
- 查看容器:
docker ps
- 停止:
docker-compose down
最后,如果你想开启 HTTPS 的话,我这里推荐用 Caddy 服务器。没用过没关系,我们写过介绍使用 Caddy 的文章特别简单。
Caddyfile 的配置内容如下:
8001 端口对应的是上面 wiki 容器的 ports 端口映射
域名 {
reverse_proxy 127.0.0.1:8001
}
复制代码
执行 caddy start
启动 Caddy 服务器,浏览器中访问对应的域名,网站初始化的引导界面,就会出现在你的面前了。
これまでのところ、上記はwiki.jsのインストールの全プロセスですが、実行していますか?
第三に、欠陥は美しさを隠しません
Wiki.jsは完璧ではありません。始めたばかりですが、軟膏にいくつかのハエが見つかりました。
-
最初の訪問時の読み込みが遅い
-
wiki.jsはアクティブに更新され、コミットが頻繁に行われますが、現在、カスタムテーマをサポートしていません
-
中国語検索には適していません。デフォルトでは中国語検索をサポートしていません。ESを使用する必要がありますが、軽量ではなくなりました。または、pgプラグインを使用してpgが中国語の単語セグメンテーションをサポートするようにします。
-
中国語の翻訳カバレッジは公式ウェブサイトに示されているほど100%ではなく、管理の背景にはまだ翻訳されていない場所があります。
しかし、それは欠陥を隠すものではなく、基本的に私がウィキに望むすべてのことを行います。そして、wikiシステムを最初から実装するよりも優れています。後で、wiki.jsを使用して新しいWebサイトを作成します。
上記の問題を乗り越えたら、PRに貢献し、より強力なwiki.jsを楽しみにしています!
第四に、最後
知識を統合する必要があります。
知識は本質的に乱雑であり、便利で強力な創造性を解き放つためには、つながりを確立し、実践的な経験を通じて秩序を保つ必要があります。
最後に、wiki.jsを使用して知識ネットワークを構築し、既存の知識を整理し、常に新しい知識を導入します。これにより、より高いブレークスルーを探すのに役立ちます。
オープンソースプロジェクトを説明するその他の記事はここにあります:github.com/HelloGitHub…