如何写好一个教程

  • 要明确和清晰的将教程分为多个步骤。
  • 核心思想要用简短的语句进行表述,并通过适当的重复来进行强化。
  • 用黑体和斜体等标注重要内容。
  • 尽可能多的使用可视化元素,以表达文字难以表述的内容。
  • 读你的教程的人可能完全是个新手,你不该期望他已经对你提到的东西有所了解。所以,不要跳过任何步骤,并且每个步骤都要尽可能详细。
  • 确保你的教程可以被你的读者理解。不要使用他们可能不懂的术语和缩写却不加以解释。
  • 给出一些讨论相关话题的文章的链接,以作参考。
  • 给出一些实际的例子并告诉他们该如何做。
  • 发表它,从而得到反馈建议并进行改进。

更多

在 Macbook 上跨平台编译 Gogs 以解决官方二进制包需要更高版本 glibc 而无法在 Anolis OS 8 上运行的问题

背景 几年前在阿里云上通过官方二进制包自托管了一套 gogs ,但是一直没有升级过。这次想一步到位升级到最新版本,却发现官方二进制包依赖更高版本的 glibc 而无法在 Anolis OS 8 上运行,最终计划通过源码编译一个二进制包来适配当前的服务器环境。 服务器环境 ##### root@AnolisOS8 ####### -------------- ##O#O## OS: Anolis OS release 8.9 x86_64 ####### Host: Alibaba Cloud ECS pc-i440fx-2.1 ########### Kernel: 4.18.0-553.40.1.0.1.an8.x86_64 ############# Uptime: 1 day, 23 hours, 40

By 熊立丁
用 Aria2 & AriaNg 搭建离线下载平台

用 Aria2 & AriaNg 搭建离线下载平台

环境 硬件:Mac Mini 2014 4C4G 操作系统:Debian 12 IP地址:192.168.2.2 流程 1. 切换到管理员权限 su root 2. 安装 aria2 apt install aria2 3. 以服务的形式运行 aria2 aria2c --enable-rpc --rpc-listen-all=true --rpc-allow-origin-all --enable-rpc 启动 rpc 服务 --rpc-listen-all=true 允许从任意 IP 访问 --rpc-allow-origin-all 允许浏览器跨域访问 4. 配置 nginx 增加站点用于放置前端界面

By 熊立丁
浙ICP备15043004号-1