¡Acostúmbrate a escribir juntos! Este es el quinto día de mi participación en el "Nuevo plan diario de Nuggets · Desafío de actualización de abril", haga clic para ver los detalles del evento .
No sé si hay alguien como yo que piense que las cosas autoconstruidas son “tierra privada” y espacio privado en Internet, y hay una especie de placer en tener un tercio de un acre de tierra propia.
Por ejemplo, un blog autoconstruido puede escribir los ensayos que quieras y puedes entretenerte sin complacer a los lectores; otro ejemplo es un wiki autoconstruido, que puede registrar directamente los puntos de conocimiento que no sabes, sin preocuparte. de que se rieran de él como de bajo nivel. Aparte de la co-construcción, Wiki es diferente de la naturaleza informal del blog.El contenido grabado presta más atención a los puntos de conocimiento y la clasificación, que se pueden utilizar para construir su propia red de conocimiento.
Si un blog se compara con un "diario", entonces un wiki es un "cuaderno". Se utiliza para registrar puntos de conocimiento, lo cual es conveniente para ver y actualizar. Tiene un directorio claro y un punto de conocimiento también se puede relacionar con otros puntos de conocimiento, expandiéndose gradualmente a "enciclopedia". Libro completo".
1. Introducción
El conocimiento está en la acumulación, y no debemos olvidar peinarnos.
Hoy, el proyecto de código abierto que vamos a presentar es wiki.js, que se usa especialmente para crear una plataforma wiki y ayudarlo a resolver los puntos de conocimiento.
Dirección: github.com/requarks/wi…
Es un proyecto wiki de código abierto liviano y poderoso, con comentarios, editor Markdown, carga de imágenes, etiquetas, búsqueda global, edición colaborativa, historial de edición, administración de usuarios, Google Analytics y otras funciones, y admite un alto grado de personalización.
La pila de tecnología utilizada también es diferente del antiguo sistema wiki, que utiliza tecnologías como Node.js, PostgreSQL, Vue.js y Docker. La implementación con un solo clic basada en Docker es bastante similar a WordPress, ¡no seas tan genial!
El punto clave es admitir chino, y la interfaz es simple y hermosa, lo cual es suficiente para que se destaque de muchos proyectos similares.
¿Sientes picazón cuando ves esto? ¡Ven conmigo abajo para hacerlo funcionar!
2. Instalación
Uno de los factores necesarios para el éxito de un proyecto de código abierto es tener una documentación detallada y fácil de entender, y las instrucciones de instalación son una prioridad.
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 服务器,浏览器中访问对应的域名,网站初始化的引导界面,就会出现在你的面前了。
Hasta ahora, lo anterior es todo el proceso de instalación de wiki.js, ¿estás ejecutando?
Tercero, los defectos no ocultan la belleza.
Wiki.js no es perfecto, y aunque recién estoy comenzando, encontré algunas moscas en el ungüento:
-
Carga lenta en la primera visita
-
Si bien wiki.js se actualiza activamente y las confirmaciones son frecuentes, actualmente no admite temas personalizados.
-
No es amigable con la búsqueda en chino, no es compatible con la búsqueda en chino de forma predeterminada, debe usar ES, pero ya no es liviano, o use el complemento pg para que pg admita la segmentación de palabras en chino
-
La cobertura de traducción al chino no es del 100% como se muestra en el sitio web oficial, y todavía hay lugares sin traducir en el fondo de gestión.
Pero no oculta los defectos, básicamente hace todo lo que quiero para un wiki. Y es mejor que implementar un sistema wiki desde cero. Luego, usaré wiki.js para crear un nuevo sitio web:
Cuando supere los problemas anteriores, contribuiré con las relaciones públicas y espero un wiki.js más potente.
Cuarto, el último
El conocimiento necesita ser integrado.
El conocimiento es inherentemente desordenado, y es necesario establecer conexiones y volverse ordenado a través de la experiencia práctica, para ser práctico y desatar una creatividad poderosa.
Finalmente, use wiki.js para construir su red de conocimiento, clasificar el conocimiento existente e introducir constantemente nuevos, ¡para que pueda ayudarlo en su camino hacia avances más importantes!
Se pueden encontrar más artículos que explican los proyectos de código abierto aquí: github.com/HelloGitHub…