意见箱
恒创运营部门将仔细参阅您的意见和建议,必要时将通过预留邮箱与您保持联络。感谢您的支持!
意见/建议
提交建议

使用VuePress快速搭建博客、在线文档、静态网站(VuePress项目创建)

来源:恒创科技 编辑:恒创科技编辑部
2022-09-09 14:00:40
VuePress介绍

VuePress 是Vuejs官方提供的一个是Vue驱动的静态网站生成器,基于Markdown语法生成网页。简单的说它就是一个快速建设文档站点的工具,在简单配置好功能后,需要做的事情就剩下写好一个个 Markdown文档。

image.png

VuePress官网

https://www.vuepress.cn


使用VuePress快速搭建博客、在线文档、静态网站(VuePress项目创建)

VuePress指南

https://www.vuepress.cn/guide...

VuePress安装

安装前请安装 Node.js

Node.js下载地址

http://www.nodejs.com.cn

你可以在一个硬盘创建一个目录,例如我再D盘的根目录下创建一个VuePress目录,然后双击进入这个目录,在这个目录的路径栏(将 D:\VuePress 替换为 cmd 然后按回车)输入CMD启动cmd来执行命令。

image.png

就会在这个目录下启动cmd命令行工具。

image.png

VuePress安装命令

npm install -D vuepress

国内请使用 cnpm 安装会更快,可执行以下命令安装 cnpm

npm install -g cnpm --registry=https://registry.npm.taobao.org

再执行以下命令安装 VuePress

cnpm install -D vuepress

image.png

直接粘贴命令按回车就可以开始安装,只要命令还在跑,都还没完成安装,需要耐心等待。

以上写得如此详细,就是为了照顾新手,大神请不要嫌弃。如果新手连以上的操作都不懂,建议还是要现学习一下Vue项目的创建、配置、运行、打包等基础知识。
创建VuePress文档
mkdir docs && echo '# Hello VuePress' > docs/README.md
配置VuePress

在你的VuePress项目目录下的 package.json 文件添加以下代码。

{
  "scripts": {
    "docs:dev": "vuepress dev docs",
    "docs:build": "vuepress build docs"
  }
}
启动VuePress项目
npm run docs:dev

image.png

启动后,将会在你的本地开启一个http服务

image.png

然后就可以通过 Markdown 语法来编写你的文档、博客、文章等内容了!

image.png

VuePress进一步配置

如果想要进一步完善你的 VuePress 文档,甚至是让 VuePress 像博客一样去使用,那么你可以根据 VuePress 官网提供的指南去进一步配置 VuePress 的导航栏、搜索、logo、侧边栏、代码高亮等,这样可以让你很快地学会使用 VuePress 来编写你的文章。

本文作者

TANKING

上一篇: 租用美国服务器:潜在的风险与应对策略。 下一篇: 从IslandsArchitecture看前端有多卷