时间:2021-05-26
使用技术:
VuePress - Vue 驱动的静态网站生成器
仓库地址:https://github.com/yinian-R/vuepress-demo
全局安装
现有项目
如果你想在一个现有项目中使用 VuePress,同时想要在该项目中管理文档,则应该将 VuePress 安装为本地依赖。
## 没有项目可以初始化yarn init## 将 VuePress 作为一个本地依赖安装yarn add -D vuepress # 或者:npm install -D vuepress## 新建一个 docs 文件夹mkdir docs## 新建一个 markdown 文件echo # Hello VuePress! > docs/README.md## 开始写作npx vuepress dev docs接着,在 package.json 里加一些脚本:
{ "scripts": { "docs:dev": "vuepress dev docs", "docs:build": "vuepress build docs" }}基本配置
一个 VuePress 网站必要的配置文件是 .vuepress/config.js,它应该导出一个 JavaScript 对象:
module.exports = { title: 'Hello VuePress', description: 'Just playing around'}静态资源
创建public文件夹,主要用于存放静态资源
.├─ docs│ └─ .vuepress│ └─ public│ └─ image│ └─ favicon.ico添加网站 favicon,修改 .vuepress/config.js 内容
module.exports = { head:[ ['link', {rel:'icon', href:'/image/favicon.ico'}] ]};导航栏
你可以通过 themeConfig.nav 增加一些导航栏链接:
module.exports = { themeConfig: { nav: [ { text: '主页', link: '/' }, { text: '指南', link: '/guide/' }, { text: '语言', items: [ { text: '中文', link: '/language/chinese/' }, { text: 'English', link: '/language/english/' } ] }, { text: 'GitHub', link: 'https://github.com' } ] }};首页
需要在dosc/README.md指定 home: true
---home: trueheroImage: /image/favicon.icoheroText: Hero 标题tagline: Hero 副标题actionText: 快速上手 →actionLink: /guide/features:- title: 简洁至上 details: 以 Markdown 为中心的项目结构,以最少的配置帮助你专注于写作。- title: Vue驱动 details: 享受 Vue + webpack 的开发体验,在 Markdown 中使用 Vue 组件,同时可以使用 Vue 来开发自定义主题。- title: 高性能 details: VuePress 为每个页面预渲染生成静态的 HTML,同时在页面被加载的时候,将作为 SPA 运行。footer: MIT Licensed | Copyright © 2018-present Evan You---侧边栏
想要使 侧边栏(Sidebar)生效,需要配置 themeConfig.sidebar,基本的配置,需要一个包含了多个链接的数组:
module.exports = { themeConfig: { sidebar: [ '/', ['/hello', 'hello page'] ] }};部署
设置部署站点的基础路径。
module.exports = { base: '/vuepress-demo/', };在你的项目中,创建一个如下的 deploy.sh 文件
#!/usr/bin/env bash# 确保脚本抛出遇到的错误set -e# 生成静态文件npm run docs:build# 进入生成的文件夹cd docs/.vuepress/dist# 如果是发布到自定义域名# echo ':yinian-R/vuepress-demo.git master:gh-pagescd -以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持。
声明:本页内容来源网络,仅供用户参考;我单位不保证亦不表示资料全面及准确无误,也不保证亦不表示这些资料为最新信息,如因任何原因,本网内容或者用户因倚赖本网内容造成任何损失或损害,我单位将不会负任何法律责任。如涉及版权问题,请提交至online#300.cn邮箱联系删除。
本文实例讲述了ASP.NET静态页生成方法。分享给大家供大家参考。具体实现方法如下:一、问题:由于业务需要,得把页面按照模板页生成静态页面,所以自己就琢磨了下,
介绍VuePress由两部分组成:一个以Vue驱动的主题系统的简约静态网站生成工具,和一个为编写技术文档而优化的默认主题。它是为了支持Vue子项目的文档需求而创
现在ssl证书的申请步骤比较简单,大家选择好申请渠道按照相关指引就可以操作,ssl证书申请后需要进行安装,ssl证书生成方法有什么步骤?SSL证书能转移吗?下面
Linux下生成MAC地址的方法有很多种,除了常见的shell生成法外,还能通过Perl、ruby等方法来生成MAC地址,下面小编对MAC地址的自动生成方法
最新开发的网站管理系统全部是静态生成的,都内含静态生成技术,很多客户不明白静态化的网站有什么好处?今天网站建设带大家详细了解下网站静态化的好处。静态化网站的意思