Prenez l'habitude d'écrire ensemble ! C'est le 5ème jour de ma participation au "Nuggets Daily New Plan · April Update Challenge", cliquez pour voir les détails de l'événement .
Je ne sais pas s'il y a quelqu'un comme moi qui pense que les choses auto-construites sont des "terres privées" et un espace privé sur Internet, et il y a une sorte de plaisir à avoir un tiers d'acre de sa propre terre.
Par exemple, un blog auto-construit peut écrire les essais que vous voulez, et vous pouvez vous divertir sans plaire aux lecteurs ; un autre exemple est un wiki auto-construit, qui peut enregistrer directement les points de connaissance que vous ne connaissez pas, sans vous inquiéter d'être moqué de bas niveau. Au-delà de la co-construction, Wiki se distingue de la nature informelle du blog, le contenu enregistré accorde plus d'attention aux points de connaissance et à la classification, qui peuvent être utilisés pour construire votre propre réseau de connaissances.
Si un blog est comparé à un "journal", alors un wiki est un "carnet". Il est utilisé pour enregistrer des points de connaissance, ce qui est pratique pour la consultation et la mise à jour. Il a un répertoire clair et un point de connaissance peut également être lié à d'autres points de connaissance, se développant progressivement en "encyclopédie". Whole Book ".
1. Introduction
La connaissance réside dans l'accumulation, et nous ne devons pas oublier de peigner.
Aujourd'hui, le projet open source que nous allons présenter est wiki.js, qui est spécialement utilisé pour construire une plate-forme wiki et vous aider à trier les points de connaissance.
Adresse : github.com/requarks/wi…
Il s'agit d'un projet open source wiki léger et puissant, avec commentaires, éditeur Markdown, téléchargement d'images, balises, recherche globale, édition collaborative, historique d'édition, gestion des utilisateurs, Google Analytics et d'autres fonctions, et prend en charge un haut degré de personnalisation.
La pile technologique utilisée est également différente de l'ancien système wiki, qui utilise des technologies telles que Node.js, PostgreSQL, Vue.js et Docker. Le déploiement en un clic basé sur Docker est assez similaire à WordPress, ne soyez pas trop cool !
Le point clé est de prendre en charge le chinois, et l'interface est simple et belle, ce qui suffit à le démarquer de nombreux projets similaires.
Avez-vous des démangeaisons quand vous voyez cela? Viens avec moi ci-dessous pour le faire fonctionner !
2. Mise en place
L'un des facteurs nécessaires au succès d'un projet open source est d'avoir une documentation détaillée et facile à comprendre, et les instructions d'installation sont une priorité absolue.
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 服务器，浏览器中访问对应的域名，网站初始化的引导界面，就会出现在你的面前了。
Jusqu'à présent, ce qui précède est l'ensemble du processus d'installation de wiki.js, exécutez-vous ?
Troisièmement, les défauts ne cachent pas la beauté
Wiki.js n'est pas parfait, et bien que je ne fasse que commencer, j'ai trouvé quelques mouches dans la pommade :
-
Chargement lent à la première visite
-
Bien que wiki.js soit activement mis à jour et que les commits soient fréquents, il ne prend actuellement pas en charge les thèmes personnalisés
-
Il n'est pas convivial pour la recherche chinoise, il ne prend pas en charge la recherche chinoise par défaut, vous devez utiliser ES, mais il n'est plus léger, ou utilisez le plugin pg pour que pg prenne en charge la segmentation des mots chinois
-
La couverture de la traduction en chinois n'est pas à 100% comme indiqué sur le site officiel, et il y a encore des endroits non traduits dans l'arrière-plan de la gestion.
Mais il ne cache pas les défauts, il fait essentiellement tout ce que je veux pour un wiki. Et c'est mieux que d'implémenter un système wiki à partir de zéro. Plus tard, j'utiliserai wiki.js pour créer un nouveau site Web :
Lorsque j'aurai résolu les problèmes ci-dessus, j'y contribuerai en termes de relations publiques et j'attends avec impatience un wiki.js plus puissant !
Quatrième, le dernier
Les connaissances doivent être intégrées.
La connaissance est intrinsèquement désordonnée, et il est nécessaire d'établir des liens et de devenir ordonné grâce à l'expérience pratique, afin d'être pratique et de libérer une créativité puissante.
Enfin, utilisez wiki.js pour construire votre réseau de connaissances, trier les connaissances existantes et en introduire constamment de nouvelles, afin qu'elles puissent vous aider à rechercher des percées plus importantes !
Plus d'articles expliquant les projets open source peuvent être trouvés ici : github.com/HelloGitHub…