首页
学习
活动
专区
圈层
工具
发布

VuePress教程之官方博客主题与插件简介

在过去 VuePress 只提供默认的文档主题,然而你可以通过它开发各种静态网站,除了文件以外,我最常看到的大概非博客莫属。 而我们在今天正式移除官方博客插件与主题的 WIP 状态。...Markdown 是一种轻量级标记式语言,创始人为约翰·格鲁伯(John Gruber)。 它允许人们「使用易读易写的纯文字格式编写文件,然后转换成有效的 XHTML(或者 HTML)文件」。...这个主题还提供了以下配置, 以下配置都要写在 .vuepress/config.js 的themeConfig 中。 以下配置都不是必要配置,请针对你的需求去选择。...默认情况下,将使用Rss feed,但也可以使用Atom和JSON feed。...例如,基于目录对帖子进行分类,例如,官方博客主题假定_posts下的所有.md文件均为博客文章,并在根目录/中列出。

1.1K30

VuePress

要生成静态的 HTML 文件,运行: yarn docs:build 或者:npm run docs:build 默认情况下,文件将会被生成在 .vuepress/dist,也可以通过 .vuepress...以上步骤都成功以后,就可以在浏览器总看到页面了,接下来就是对页面进行布局 主题配置 本文是根据VuePress默认主题配置 1.首页 在docs文件夹下创建.vuepress文件夹和README.md文件...下一步是如何在markdown中使用vue组件,也就是在页面中展示自己的项目。 在markdown中使用Vue 在.vuepress中创建components文件夹。...放在public文件夹中,可以在components文件夹中的组件引入。 这是docs文件夹目录结构 ?...如: 注意:在markdown文件中如果需要给组件名缩进,不要用tab键,会被当做markdown语法解析。

1.4K10
  • 您找到你想要的搜索结果了吗?
    是的
    没有找到

    Markdown 拓展-使用 vue.press 生成网站

    你可以使用 Markdown在新窗口打开 来书写内容(如文档、博客等),然后 VuePress 会帮助你生成一个静态网站来展示它们。...build docs" } } 将默认的临时目录和缓存目录添加到 .gitignore 文件中 echo 'node_modules' >> .gitignore echo '.temp' >>...这个功能是默认启用的,你可以通过配置来禁用它。 你可以在代码块添加 :line-numbers / :no-line-numbers 标记来覆盖配置项中的设置。...总结 优点:配套工具较为完善,默认给的主题已经集成度很高了,自定义选项多,更适合程序员发的文档。...使用的是默认的构建输出目录 (.vuepress/dist) ; 注意构建产物的路径问题,需要设置正确的 base 选项。

    1.8K10

    使用Vuepress和Nginx搭建个人博客

    使用Vuepress和Nginx搭建个人博客 ## Vuepress VuePress 由两部分组成:第一部分是一个极简静态网站生成器 (opens new window),它包含由 Vue 驱动的主题系统和插件...API,另一个部分是为书写技术文档而优化的默认主题,它的诞生初衷是为了支持 Vue 及其子项目的文档需求。...而VuePress除了使用Vue外,还继承了Vue各项能力,比如使用stylus写css,也能通过enhanceApp来增强应用,比如在Vuepress中使用Vuex等等。...后续将介绍如果安装Vuepress,如果使用enhanceApp,如果使用stylus,如何在Vuepress中自定义主题,并且最终将vuepress内容发布到Nginx供internet访问。...run docs:build 命令可以编译生成所有的静态html文件,这些静态文件可以配置在nginx服务器直接访问 vuepress目录结构 ├── docs │ ├── .vuepress (

    1.4K30

    如何构建自己的技术博客

    markdown 是美国科技博主 John Gruber 于 2004 年推出,是一种纯文本格式的轻量级标记语言。...主题配置 一个 VuePress 主题应该负责整个网站的布局和交互细节。在 VuePress 中,目前自带了一个默认的主题(正是你现在所看到的),它是为技术文档而设计的。...同时,默认主题提供了一些选项,让你可以去自定义导航栏(navbar)、 侧边栏(sidebar)和 首页(homepage) 等 默认主题: 首页 修改首页,修改 docs/README.md,VuePress...在 .vuepress/config.js 配置文件中,通过 themeConfig.nav 增加一些导航栏链接: // .vuepress/config.js module.exports = {.../config.js 配置文件中,通过 themeConfig.sidebar 增加侧边栏配置: // .vuepress/config.js module.exports = { ...

    56830

    团队技术文档构建利器vuepress上手实践

    参数配置 vuepress 提供了两类配置: 配置文件,如 .vuepress/config.js,需要导出一个js对象,一般用于进行全局配置 YAML front matter,配置在 md 文件头部...3.1.1 主页(homepage) 默认主题提供了一个首页(Homepage)布局,用于网站的主页 docs/README.md,使用 YAML front matter 配置。...index.styl 作为全局样式文件生成在最终的css文件结尾,具有比默认样式更高的优先级,palette.styl 用于重写默认样式常量,或者设置新的 stylus 颜色常量,如: $accentColor...在 Markdown 中使用 Vue .vuepress/components 中的所有 *.vue 文件都会自动注册为全局异步组件,如: . └─ .vuepress └─ components...自定义主题 创建 .vuepress/theme 目录和 Layout.vue 文件,详见文档。 7.

    1.6K20

    团队技术文档构建利器vuepress上手实践

    参数配置 vuepress 提供了两类配置: 配置文件,如 .vuepress/config.js,需要导出一个js对象,一般用于进行全局配置 YAML front matter,配置在 md 文件头部...3.1.1 主页(homepage) 默认主题提供了一个首页(Homepage)布局,用于网站的主页 docs/README.md,使用 YAML front matter 配置。...index.styl 作为全局样式文件生成在最终的css文件结尾,具有比默认样式更高的优先级,palette.styl 用于重写默认样式常量,或者设置新的 stylus 颜色常量,如: $accentColor...在 Markdown 中使用 Vue .vuepress/components 中的所有 *.vue 文件都会自动注册为全局异步组件,如: . └─ .vuepress └─ components...自定义主题 创建 .vuepress/theme 目录和 Layout.vue 文件,详见文档。 7.

    2.7K94

    尤小右:VitePress 初步实现小目标,极简静态站点生成器

    默认的主题是不存在的,但基本的工作流程是有的。 定制化 可以通过.vitepress/config.js进行配置(见src/config.ts)。 您可以通过添加以下文件来开发您的自定义主题。...从根本上讲,这是因为VuePress是一个底层的Webpack应用程序。即使只有两页,也要编译完整的webpack项目(包括所有主题源文件)。...注意,在应用优化的同时,用户仍然可以在标记内容中自由混合Vue组件 - 编译器会自动为你做静态/动态分离,你永远不需要考虑。...它鼓励使用原生JavaScript和CSS变量进行主题设计。 这将成为未来的下一个VuePress吗? 也许!...但是总的想法是,VitePress将具有尽可能少的主题API(最好使用JavaScript API而不是文件布局约定),并且可能没有插件(所有自定义均在主题中完成)。

    3.4K30

    💰手把手教你用VuePress如何快速搭建个人免费网站?

    这里使用的官方默认主题: 左上角的logo与title 右上角的全局搜索框与nav导航栏 左侧的sidebar导航栏(自动将md一级标题设置为导航文案) 右侧的markdown内容 注意:项目自带热更新...变更主题(可选) ① 更换主题: 对默认主题不满意,想换个别的主题?安排!...在config.js中设置: module.exports = { theme: 'vuepress-theme-xx' } 可以在npm中寻找自己喜欢的主题,其中以 @vuepress/theme...执行如下命令,可将默认主题的各功能组件释放出来: vuepress eject docs 你会发现,在根目录下,多了一个theme文件夹,如下: 上图列出了主要的布局组件,只需在其中做适量修改以满足业务需求即可...9. md文件中使用vue组件(可选) vuepress项目中的md文件,可以直接使用vue组件。

    1.9K21

    VuePress搭建技术网站与个人博客

    初始化项目 npm init \-y // 默认配置yes 在生成的package.json中,添加如下两个启动命令: "scripts": { "dev": "vuepress dev docs"...这里使用的官方默认主题: 左上角的logo与title 右上角的全局搜索框与nav导航栏 左侧的sidebar导航栏(自动将md一级标题设置为导航文案) 右侧的markdown内容 注意:项目自带热更新...在config.js中设置: module.exports = { theme: 'vuepress-theme-xx' } 可以在npm中寻找自己喜欢的主题,其中以 @vuepress/theme...那就在默认主题基础上做一些修改,以满足需求。 执行如下命令,可将默认主题的各功能组件释放出来: vuepress eject docs 你会发现,在根目录下,多了一个theme文件夹,如下: ?...9. md文件中使用vue组件(可选) vuepress项目中的md文件,可以直接使用vue组件。

    2K10

    第一个博客搭建之Vuepress

    感谢 vuepress-theme-reco主题与一篇博客使用文章使用 vuepress 构建个人博客 在写这篇文章前,本人非前端专业人士,只是一时兴起想开始搭建一个博客,在该博客上记录与分享一下自己所学的一切内容...其余相关的 key 和 publish 等相关参数还请读者查看 reco 主题的官方文档立即前往与 vuepress 官网立即前往 样式修改​ 可能你会局限于 reco 主题的默认样式,这里就说下如何修改样式...当然你已经觉得 reco 主题都很完美了,不需要更改源码,那么你只需要在 .vuepress/styles/ 来创建文件index.styl来方便地添加额外样式(还有一个默认样式,不推荐修改),然后把你要修改的样式代码写在...自己搭建遇到的坑​ 图片路径​ 首先就是 markdown 图片相对路径的坑,在写文章的话,如果涉及的本地图片引入,那么默认不操作的,也就是需要配置一下,默认在当前同级文件下,在创建一个文件名相同的文件夹来存放图片...参考 Vuepress 图片资源中文路径问题 完美解决上述问题 引入 UI 组件库报错​ 如果你在该主题使用其他 UI 组件库,如 element,ant design,那么你很有可能会编译失败,官方解释

    96410

    VuePress-theme-hope2 搭建个人网站,保姆级教程,包含自动部署、评论、搜索等功能

    你喜欢哪个主题 因为VuePress除了默认的主题外,提供了扩展主题、扩展插件的能力,不同的主题又组织了不同的插件集合来完成开箱即用的功能, 所以,你首先应该使用哪款主题作为你的个人完整风格。...首先,我们看看各个主题默认的样式 默认主题案例 vue系列早先版本的官网大多数都是默认主题 vuepress-theme-hope案例 蝉沐风的码场: https://www.chanmufeng.com...相反,vuepress-theme-hope 这些做的都不错,成为我新的选择。 搭建项目 初始化项目 如果你选择了一个主题,请务必使用该主题提供的脚手架工具创建项目。...导航栏的相关设置在 navbar.ts文件中。 默认为字符串,对应 src 目录下的文件路径,你可以省略 .md 扩展名,以 / 结尾的路径会被推断为 /README.md。...例如: 搜索功能 该主题内置了几种常见搜索插件的支持,你只需下载你喜欢的插件和配置文件即可,我使用的是vuepress-plugin-search-pro插件,配置参考的官方配置。

    56411

    关于-文章搭建

    依赖关系从项目package.json文件中检索,并存储在yarn.lock文件中。...如果你以前使用过 Vue 的话,当你在开发一个自定义主题的时候,你会感受到非常熟悉的开发体验,你甚至可以使用 Vue DevTools 去调试你的自定义主题。...opens new window) 导入代码段(opens new window) 在 Markdown 中 使用 Vue 模板语法(opens new window) 使用组件(opens new window...#GitBook 我们的子项目文档一直都在使用 GitBook。GitBook 最大的问题在于当文件很多时,每次编辑后的重新加载时间长得令人无法忍受。...它的默认主题导航结构也比较有限制性,并且,主题系统也不是 Vue 驱动的。GitBook 背后的团队如今也更专注于将其打造为一个商业产品而不是开源工具。

    1.6K30

    vuePress

    VuePress 由两部分组成:第一部分是一个极简静态网站生成器(opens new window),它包含由 Vue 驱动的主题系统和插件 API,另一个部分是为书写技术文档而优化的默认主题,它的诞生初衷是为了支持...install -D vuepress ### 3.配置 package.json 在 package.json 中添加一些 scripts(opens new window)这一步骤是可选的,但我们推荐你完成它....安装主题 vuepress-theme-reco yarn add vuepress-theme-reco # npm install vuepress-theme-reco --save-dev ​...- title: Vue驱动 details: 享受 Vue + webpack 的开发体验,在 Markdown 中使用 Vue 组件,同时可以使用 Vue 来开发自定义主题。....vuepress 文件夹 这个文件是全局重要的配置文件,包括配置网站的标题、描述、主题、导航栏等信息,内容如下: module.exports = { title: "XXX的博客", description

    66010
    领券