关于-文章搭建

# 关于-文章搭建

# 配置环境

git(版本控制)
下载地址 (opens new window)(最新版就OK，下载速度较慢一些，可以问我要安装包)

node(核心)
下载地址 (opens new window)(最新版本就行)

yarn(npm包管理的替代)
下载地址 (opens new window)(最新版本就行)

vscode(编辑器)
下载地址 (opens new window)(最新版本就行)

# 验证

环境安装成功了

# 快速上手

If you want to learn the details of each step by yourself, such as the use of GIT command, how to configure navigation bar, sidebar, global configuration, how to realize automatic deployment, install useful plug-ins, use good-looking themes, etc

如果你已经学过git和vuepress的基本使用，可以直接克隆我的项目，修改就可以了

git clone git@github.com:xustudyxu/xustudyxu.github.io.git

在项目中右键git bash,执行命令yarn install用于安装项目的所有依赖项。依赖关系从项目package.json文件中检索，并存储在yarn.lock文件中。
本地启动命令

vuepress dev docs

构建，生成静态文件

vuepress build docs

# Vuepress介绍

VuePress 由两部分组成：第一部分是一个极简静态网站生成器 (opens new window)，它包含由 Vue 驱动的主题系统 (opens new window)和插件 API (opens new window)，另一个部分是为书写技术文档而优化的默认主题 (opens new window)，它的诞生初衷是为了支持 Vue 及其子项目的文档需求。

每一个由 VuePress 生成的页面都带有预渲染好的 HTML，也因此具有非常好的加载性能和搜索引擎优化（SEO）。同时，一旦页面被加载，Vue 将接管这些静态内容，并将其转换成一个完整的单页应用（SPA），其他的页面则会只在用户浏览到的时候才按需加载。

# 它是如何工作的?

事实上，一个 VuePress 网站是一个由 Vue (opens new window)、Vue Router (opens new window)和 webpack (opens new window)驱动的单页应用。如果你以前使用过 Vue 的话，当你在开发一个自定义主题的时候，你会感受到非常熟悉的开发体验，你甚至可以使用 Vue DevTools 去调试你的自定义主题。

在构建时，我们会为应用创建一个服务端渲染（SSR）的版本，然后通过虚拟访问每一条路径来渲染对应的HTML。这种做法的灵感来源于 Nuxt (opens new window)的 nuxt generate 命令，以及其他的一些项目，比如 Gatsby (opens new window)。

# Features

内置的 Markdown 拓展

在 Markdown 中使用 Vue

Vue驱动的自定义主题系统

默认主题

博客主题

Plugin

# 为什么不是...?

# Nuxt

VuePress 能做的事情，Nuxt 理论上确实能够胜任，但 Nuxt 是为构建应用程序而生的，而 VuePress 则专注在以内容为中心的静态网站上，同时提供了一些为技术文档定制的开箱即用的特性。

# Docsify / Docute

这两个项目同样都是基于 Vue，然而它们都是完全的运行时驱动，因此对 SEO 不够友好。如果你并不关注 SEO，同时也不想安装大量依赖，它们仍然是非常好的选择！

# Hexo

Hexo 一直驱动着 Vue 的文档 —— 事实上，在把我们的主站从 Hexo 迁移到 VuePress 之前，我们可能还有很长的路要走。Hexo 最大的问题在于他的主题系统太过于静态以及过度地依赖纯字符串，而我们十分希望能够好好地利用 Vue 来处理我们的布局和交互，同时，Hexo 的 Markdown 渲染的配置也不是最灵活的。

# GitBook

我们的子项目文档一直都在使用 GitBook。GitBook 最大的问题在于当文件很多时，每次编辑后的重新加载时间长得令人无法忍受。它的默认主题导航结构也比较有限制性，并且，主题系统也不是 Vue 驱动的。GitBook 背后的团队如今也更专注于将其打造为一个商业产品而不是开源工具。

你可以参考这两篇官方文档：

Vuepress

Vue 驱动的静态站点生成器

vuepress-theme-vdoing

🚀一款简洁高效的VuePress 知识管理&博客主题

- name: Vuepress
  desc: Vue 驱动的静态站点生成器
  avatar: https://vuepress.vuejs.org/hero.png # 可选
  link: https://vuepress.vuejs.org/ # 可选
  bgColor: '#CBEAFA' # 可选，默认var(--bodyBg)。颜色值有#号时请添加单引号
  textColor: '#6854A1' # 可选，默认var(--textColor)
- name: vuepress-theme-vdoing
  desc: 🚀一款简洁高效的VuePress 知识管理&博客 主题
  avatar: https://cdn.jsdelivr.net/gh/xugaoyi/image_store/blog/20200409124835.png
  link: https://doc.xugaoyi.com/
  bgColor: '#CBEAFA'
  textColor: '#6854A1'

1
2
3
4
5
6
7
8
9
10
11
12

参考:https://vuepress.vuejs.org/zh/

#关于

上次更新: 2024/04/21, 09:42:22

← 关于-我关于-github的六个神技巧→