Linux系统之安装showdoc文档工具

这篇具有很好参考价值的文章主要介绍了Linux系统之安装showdoc文档工具。希望对大家有所帮助。如果存在错误或未考虑完全的地方,请大家不吝赐教,您也可以点击"举报违法"按钮提交疑问。

一、showdoc介绍

1.1 showdoc简介

Showdoc是一款在线文档工具,支持Markdown语法,可以用于快速记录、分享和协作文档。它拥有简洁的界面和丰富的功能,包括在线编辑、多人协作、讨论评论、版本管理、权限管理等特性。

1.2 showdoc功能

  • 分享与导出:响应式网页设计,可将项目文档分享到电脑或移动设备查看。同时也可以将项目导出成word文件,以便离线浏览。
  • 权限管理:公开项目与私密项目、项目转让、项目成员、团队管理。
  • 编辑功能: markdown编辑、模板插入、历史版本。
  • 多平台:showdoc支持网页版、手机app版和电脑客户端版。
  • 自动化:可从代码注释中自动生成文档、搭配的RunApi客户端,可调试接口和自动生成文档。
  • 快速部署:可使用使用开源版本showdoc,快速在本地服务器部署showdoc。

二、本地环境介绍

2.1 本地环境规划

本次实践为个人测试环境,服务器操作系统版本为centos7.6。

hostname IP地址 操作系统版本 内核版本
jeven 192.168.3.166 centos 7.6 3.10.0-957.el7.x86_64

2.2 本次实践介绍

1.本次实践部署环境为个人测试环境;
2.在centos7.6环境下安装showdoc文档工具。

三、检查本地环境

3.1 检查本地操作系统版本

检查本地操作系统版本

[root@jeven ~]# cat /etc/redhat-release 
CentOS Linux release 7.6.1810 (Core) 

3.2 检查系统内核版本

检查系统内核版本

[root@jeven ~]# uname -r 
3.10.0-957.el7.x86_64

3.3 检查本地yum仓库状态

  • 配置阿里云的镜像源
curl -o /etc/yum.repos.d/CentOS-Base.repo https://mirrors.aliyun.com/repo/Centos-7.repo
sed -i -e '/mirrors.cloud.aliyuncs.com/d' -e '/mirrors.aliyuncs.com/d' /etc/yum.repos.d/CentOS-Base.repo
  • 检查本地yum仓库状态
[root@jeven yum.repos.d]# yum repolist all |grep  enable 
base/7/x86_64         CentOS-7 - Base - mirrors.aliyun.com       enabled: 10,072
extras/7/x86_64       CentOS-7 - Extras - mirrors.aliyun.com     enabled:    515
updates/7/x86_64      CentOS-7 - Updates - mirrors.aliyun.com    enabled:  4,996

四、安装httpd服务

4.1 安装httpd

使用使用yum安装httpd

[root@jeven yum.repos.d]# yum -y install httpd
Loaded plugins: fastestmirror, langpacks
Loading mirror speeds from cached hostfile
base                                                                                                                            | 3.6 kB  00:00:00     
extras                                                                                                                          | 2.9 kB  00:00:00     
updates                                                                                                                         | 2.9 kB  00:00:00     
Resolving Dependencies
--> Running transaction check
---> Package httpd.x86_64 0:2.4.6-99.el7.centos.1 will be installed
--> Processing Dependency: httpd-tools = 2.4.6-99.el7.centos.1 for package: httpd-2.4.6-99.el7.centos.1.x86_64
--> Processing Dependency: /etc/mime.types for package: httpd-2.4.6-99.el7.centos.1.x86_64
--> Processing Dependency: libaprutil-1.so.0()(64bit) for package: httpd-2.4.6-99.el7.centos.1.x86_64
--> Processing Dependency: libapr-1.so.0()(64bit) for package: httpd-2.4.6-99.el7.centos.1.x86_64
--> Running transaction check
---> Package apr.x86_64 0:1.4.8-7.el7 will be installed
---> Package apr-util.x86_64 0:1.5.2-6.el7_9.1 will be installed
---> Package httpd-tools.x86_64 0:2.4.6-99.el7.centos.1 will be installed
---> Package mailcap.noarch 0:2.1.41-2.el7 will be installed
--> Finished Dependency Resolution

Dependencies Resolved

=======================================================================================================================================================
 Package                            Arch                          Version                                         Repository                      Size
=======================================================================================================================================================
Installing:
 httpd                              x86_64                        2.4.6-99.el7.centos.1                           updates                        2.7 M
Installing for dependencies:
 apr                                x86_64                        1.4.8-7.el7                                     base                           104 k
 apr-util                           x86_64                        1.5.2-6.el7_9.1                                 updates                         92 k
 httpd-tools                        x86_64                        2.4.6-99.el7.centos.1                           updates                         94 k
 mailcap                            noarch                        2.1.41-2.el7                                    base                            31 k

Transaction Summary
=======================================================================================================================================================
Install  1 Package (+4 Dependent packages)

Total download size: 3.0 M
Installed size: 10 M
Downloading packages:
(1/5): apr-1.4.8-7.el7.x86_64.rpm                                                                                               | 104 kB  00:00:00     
(2/5): apr-util-1.5.2-6.el7_9.1.x86_64.rpm                                                                                      |  92 kB  00:00:00     
(3/5): mailcap-2.1.41-2.el7.noarch.rpm                                                                                          |  31 kB  00:00:00     
(4/5): httpd-tools-2.4.6-99.el7.centos.1.x86_64.rpm                                                                             |  94 kB  00:00:00     
(5/5): httpd-2.4.6-99.el7.centos.1.x86_64.rpm                                                                                   | 2.7 MB  00:00:06     
-------------------------------------------------------------------------------------------------------------------------------------------------------
Total                                                                                                                  474 kB/s | 3.0 MB  00:00:06     
Running transaction check
Running transaction test
Transaction test succeeded
Running transaction
  Installing : apr-1.4.8-7.el7.x86_64                                                                                                              1/5 
  Installing : apr-util-1.5.2-6.el7_9.1.x86_64                                                                                                     2/5 
  Installing : httpd-tools-2.4.6-99.el7.centos.1.x86_64                                                                                            3/5 
  Installing : mailcap-2.1.41-2.el7.noarch                                                                                                         4/5 
  Installing : httpd-2.4.6-99.el7.centos.1.x86_64                                                                                                  5/5 
  Verifying  : httpd-2.4.6-99.el7.centos.1.x86_64                                                                                                  1/5 
  Verifying  : mailcap-2.1.41-2.el7.noarch                                                                                                         2/5 
  Verifying  : apr-1.4.8-7.el7.x86_64                                                                                                              3/5 
  Verifying  : httpd-tools-2.4.6-99.el7.centos.1.x86_64                                                                                            4/5 
  Verifying  : apr-util-1.5.2-6.el7_9.1.x86_64                                                                                                     5/5 

Installed:
  httpd.x86_64 0:2.4.6-99.el7.centos.1                                                                                                                 

Dependency Installed:
  apr.x86_64 0:1.4.8-7.el7     apr-util.x86_64 0:1.5.2-6.el7_9.1     httpd-tools.x86_64 0:2.4.6-99.el7.centos.1     mailcap.noarch 0:2.1.41-2.el7    

Complete!

4.2 启动httpd服务

  • 启动httpd服务并使开机自启
systemctl enable --now httpd
  • 检查httpd服务状态
[root@jeven yum.repos.d]# systemctl status httpd
● httpd.service - The Apache HTTP Server
   Loaded: loaded (/usr/lib/systemd/system/httpd.service; enabled; vendor preset: disabled)
   Active: active (running) since Thu 2023-06-22 16:39:57 CST; 35s ago
     Docs: man:httpd(8)
           man:apachectl(8)
 Main PID: 45406 (httpd)
   Status: "Total requests: 0; Current requests/sec: 0; Current traffic:   0 B/sec"
    Tasks: 6
   Memory: 2.9M
   CGroup: /system.slice/httpd.service
           ├─45406 /usr/sbin/httpd -DFOREGROUND
           ├─45407 /usr/sbin/httpd -DFOREGROUND
           ├─45408 /usr/sbin/httpd -DFOREGROUND
           ├─45409 /usr/sbin/httpd -DFOREGROUND
           ├─45410 /usr/sbin/httpd -DFOREGROUND
           └─45411 /usr/sbin/httpd -DFOREGROUND

Jun 22 16:39:51 jeven systemd[1]: Starting The Apache HTTP Server...
Jun 22 16:39:57 jeven systemd[1]: Started The Apache HTTP Server.

4.3 设置防火墙和selinux

  • 防火墙设置,关闭防火墙。
systemctl stop firewalld && systemctl disable firewalld  
  • 防火墙设置,当需要开启防火墙的时候,可以放行80端口。
 firewall-cmd --zone=public  --permanent --add-port=80/tcp
 firewall-cmd --reload
  • 关闭selinux
setenforce 0
sed -i 's/SELINUX=enforcing/SELINUX=disabled/' /etc/selinux/config
getenforce 

4.4 测试httpd服务

在本地浏览器,访问http://192.168.3.166/,实际请将IP替换为自己服务器的IP地址。
网站内容可以正常打开,表示httpd服务是正常的。

Linux系统之安装showdoc文档工具

五、安装php服务

5.1 安装php工具

直接使用yum安装php及其相关模块。

yum -y install php php-gd php-mbstring php-pdo

Linux系统之安装showdoc文档工具

5.2 编辑info.php测试文件

编辑info.php测试文件

[root@jeven ~]# cat /var/www/html/info.php 
<?php
phpinfo();
?>

5.3 重启hhtpd服务

重启hhtpd服务

systemctl restart httpd

5.4 查看php安装状态

在浏览器,http://192.168.3.166/info.php
出现以下页面,表示php安装正常。

Linux系统之安装showdoc文档工具

六、部署ShowDoc应用

6.1 创建下载目录

创建ShowDoc软件包的下载目录

[root@jeven ~]# mkdir -p /data/showdoc
[root@jeven ~]# cd /data/showdoc/

6.2 下载ShowDoc软件包

下载ShowDoc软件包

[root@jeven showdoc]#  git  clone  https://github.com/star7th/showdoc.git
Cloning into 'showdoc'...
remote: Enumerating objects: 20220, done.
remote: Counting objects: 100% (1812/1812), done.
remote: Compressing objects: 100% (624/624), done.
remote: Total 20220 (delta 1259), reused 1643 (delta 1139), pack-reused 18408
Receiving objects: 100% (20220/20220), 21.71 MiB | 4.48 MiB/s, done.
Resolving deltas: 100% (11942/11942), done.

6.3 拷贝目录

将showdoc下的内容移动到网站根目录下

  mv  -f  showdoc/*  /var/www/html/

6.4 目录权限设置

将网站根目录/var/www/html的所属用户改为apache

chown  -R  apache:apache  /var/www/html

6.5 重启httpd服务

重启httpd服务

 systemctl restart httpd

七、showdoc的初始化设置

7.1 设置系统中文语言

访问:http://192.168.3.166/install/index.php,将IP替换为自己服务器的IP地址,
进入showdoc的初始配置页面,选择系统中文语言。

Linux系统之安装showdoc文档工具

Linux系统之安装showdoc文档工具

7.2 访问ShowDoc首页

访问地址:http://192.168.3.166/web/#/
进入ShowDoc首页

Linux系统之安装showdoc文档工具

八、ShowDoc的基本使用

8.1 登录showdoc文档系统

http://192.168.3.166/web/#/user/login
默认账号密码showdoc/123456

Linux系统之安装showdoc文档工具

Linux系统之安装showdoc文档工具

8.2 查看示例文档效果

打开首页的API等示例文档,可以看到展现效果,可以自己单独创建项目,管理各种文档,非常方便。

Linux系统之安装showdoc文档工具
Linux系统之安装showdoc文档工具

8.3 创建新项目

创建一个新项目,填写项目信息。

Linux系统之安装showdoc文档工具
Linux系统之安装showdoc文档工具

8.4 添加文档

添加文档。编辑文本内容,这里直接使用默认模板来测试。

Linux系统之安装showdoc文档工具
Linux系统之安装showdoc文档工具
Linux系统之安装showdoc文档工具

8.5 分享文档

选择分享文档,复制文档链接。

Linux系统之安装showdoc文档工具

Linux系统之安装showdoc文档工具

8.6 查看分享文档

打开分享文档链接,查看分享文档内容。

Linux系统之安装showdoc文档工具

九、showdoc的后台管理

9.1 登录后台管理

访问地址:http://192.168.3.166/web/#/admin/index

Linux系统之安装showdoc文档工具

9.2 用户管理

用户管理页面,新增用户,填写用户信息。

Linux系统之安装showdoc文档工具

Linux系统之安装showdoc文档工具

9.3 项目管理

在项目管理页面,可以查看所有的项目。

Linux系统之安装showdoc文档工具

9.4 附件管理

可以对文档中的附件进行管理。

Linux系统之安装showdoc文档工具

9.5 站点设置

可以对本地站点进行基本设置。

Linux系统之安装showdoc文档工具
备注:本文禁止转载,转载需要获得本人授权。
现本人CSDN-id:jks212454授权在微信公众号:运维江湖客,id:gh_2eaa06b92a76发表该博文文章来源地址https://www.toymoban.com/news/detail-501754.html

到了这里,关于Linux系统之安装showdoc文档工具的文章就介绍完了。如果您还想了解更多内容,请在右上角搜索TOY模板网以前的文章或继续浏览下面的相关文章,希望大家以后多多支持TOY模板网!

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处: 如若内容造成侵权/违法违规/事实不符,请点击违法举报进行投诉反馈,一经查实,立即删除!

领支付宝红包 赞助服务器费用

相关文章

  • Centos操作系统 前期必备工具VMWare软件介绍及安装

            大家想要安装Centos系统之前,必须先安装VMware虚拟机软件         VMware下载地址https://www.onlinedown.net/soft/984087.htm         后期我会发布centos7操作系统的详细安装教程        https://blog.csdn.net/m0_68495664/article/details/129272170 VMWare 软件介绍         VMware WorkSt

    2024年02月09日
    浏览(64)
  • 交叉编译工具 aarch64-linux-gnu-gcc 的介绍与安装

    AArch64 是随 ARMv8 ISA 一起引入的 64 位架构,用于执行 A64 指令的计算机。而且在 AArch64 状态下执行的代码只能使用 A64 指令集。,而不能执行 A32 或 T32 指令。但是,与 AArch32 中不同,在64位状态下,指令可以访问 64 位和 32 位寄存器。 aarch64-linux-gnu-gcc 是一个交叉编译工具链,可

    2024年04月14日
    浏览(49)
  • Linux hwclock工具介绍(hwclock --systohc、hwclock --hctosys)硬件时钟和系统时钟(硬件时间、系统时间)(时间同步)

    hwclock是Linux系统中的一个重要工具,它主要用于读取和设置硬件时钟。本文将围绕 hwclock --systohc 和 hwclock --hctosys 两个命令进行深入探讨。 在深入讨论hwclock之前,需要先理解硬件时钟和系统时钟的区别。 硬件时钟 (也被称为实时时钟,RTC):它是指电脑主板上的独立的时钟

    2024年02月04日
    浏览(45)
  • 1-Linux操作系统 的介绍和安装教程

    一、Linux 的介绍 1)常见的操作系统 Windows,它微软公司开发的一款桌面操作系统(闭源系统)。版本有dos、win98、win NT、win XP、win 7、win vista、win 8、win 10。服务器操作系统:win server 2003、win server 2008、win server 2012。 Mac,苹果公司开发的一款操作系统(闭源系统),目前最新

    2024年02月08日
    浏览(48)
  • 安装pycocotools工具(Windows/Linux系统通用)

    今天在执行命令 pip install pycocotools 命令的时候遭遇了如下令人匪夷所思的错误: 在网上尝试了很多种方法去安装 pycocotools 都以失败告终,机缘巧合找到了一种方法,亲测可用。 机缘巧合下自己拼凑了一种可用的方法,总结如下,希望大家少走弯路: 先检查自己有没有下载

    2024年02月16日
    浏览(42)
  • 持续集成工具Jenkins的使用之安装篇(一)

    Jenkins是一个基于Java开发的开源的一种持续集成工具,主要用于环境部署,监控重复性的工作,旨在提供一个开放易用的软件平台,使软件项目可以进行持续集成。要想使用它,你就必须的先安装,接下来我们就介绍下Jenkins是如何安装 。 安装步骤如下: 下载Java安装包,因为

    2024年01月23日
    浏览(50)
  • ROS仿真R2机器人之安装运行及MoveIt的介绍

            R2(Robonaut 2) 是NASA美国宇航局与GM通用联合推出的宇航人形机器人,能在国际空间站使用,可想而知其价格是非常昂贵,几百万美刀吧,还好NASA发布了一个R2机器人的Gazebo模型,使用模型就不需要花钱了,由于我们的机器人软件通常是不依赖于具体机器人的,所以在

    2024年02月03日
    浏览(43)
  • 【开发工具】适用于Windows的Linux子系统一一WSL安装使用教程

    一、简介 Windows Subsystem for Linux(简称WSL)是一个在Windows 1011上能够运行原生Linux二进制可执行文件(ELF格式)的兼容层。它是由微软与Canonical公司合作开发,其目标是使纯正的Ubuntu、Debian等映像能下载和解压到用户的本地计算机,并且映像内的工具和实用工具能在此子系统上

    2024年02月05日
    浏览(60)
  • Linux之安装配置CentOS 7

    目录 一.概述         1.1 什么是Linux系统 二.安装CentOS 7 三. 配置CentOS 7 四. 查看、设置IP地址         4.1 查看IP地址         4.2 设置IP地址  五.换软件源 Linux是一套免费使用和自由传播的类Unix操作系统,是一个多用户、多任务、支持多线程和多CPU的操作系统。它能运行主要

    2024年01月25日
    浏览(49)
  • Linux之安装配置CentOS7+换源

    目录 一. 安装CentOS7 二. 配置CentOS7 三. 查看、设置IP地址         3.1 查看IP地址         3.2 设置IP地址  四. 使用Xshell连接Linux客户端         4.1 Xshell的下载         4.2 Xshell的使用  五. 换软件源 博主是在虚拟机中进行安装的,大家也可以在虚拟机中跟着尝试一下 第一步

    2024年01月25日
    浏览(41)

觉得文章有用就打赏一下文章作者

支付宝扫一扫打赏

博客赞助

微信扫一扫打赏

请作者喝杯咖啡吧~博客赞助

支付宝扫一扫领取红包,优惠每天领

二维码1

领取红包

二维码2

领红包