zoukankan      html  css  js  c++  java
  • 02-VuePress 设计-运行原理

    1、什么VuePress

      一个 VuePress 网站是一个由 VueVue Router 和 webpack 驱动的单页应用

     

    2、快速上手VuePress

    // 安装yarn: https://classic.yarnpkg.com/zh-Hans/docs/install#windows-stable
    
    # 将 VuePress 作为一个本地依赖安装
    yarn add -D vuepress # 或者:npm install -D vuepress
    // 1、创建文件夹,并进入
    mkdir vuepress-starter && cd vuepress-starter  
    // 2、初始化项目
    yarn create vuepress
    // 3、启动项目
    yarn dev

     

    • docs/.vuepress: 用于存放全局的配置、组件、静态资源等。
    • docs/.vuepress/components: 该目录中的 Vue 组件将会被自动注册为全局组件。
    • docs/.vuepress/theme: 用于存放本地主题。
    • docs/.vuepress/styles: 用于存放样式相关的文件。
    • docs/.vuepress/styles/index.styl: 将会被自动应用的全局样式文件,会生成在最终的 CSS 文件结尾,具有比默认样式更高的优先级。
    • docs/.vuepress/styles/palette.styl: 用于重写默认颜色常量,或者设置新的 stylus 颜色常量。
    • docs/.vuepress/public: 静态资源目录。
    • docs/.vuepress/templates: 存储 HTML 模板文件。
    • docs/.vuepress/templates/dev.html: 用于开发环境的 HTML 模板文件。
    • docs/.vuepress/templates/ssr.html: 构建时基于 Vue SSR 的 HTML 模板文件。
    • docs/.vuepress/config.js: 配置文件的入口文件,也可以是 YML 或 toml
    • docs/.vuepress/enhanceApp.js: 客户端应用的增强。

    3、VuePress主题

    module.exports = {
        theme: 'vuepress-theme-x',  //配置主题名字 --  官方和社区的主题
        themeConfig: { //主题的其他配置
            //...
        }
    }
    // 自定义主题
    首先在你文档根目录创建一个 .vuepress/theme 目录,
    接着创建一个 Layout.vue 文件:
      
    到这里,就像开发一个普通的 Vue 应用一样。如何组织你的主题,这完全取决于你。

    4、插件

    // 插件使用
    你可以通过在 .vuepress/config.js 中做一些配置来使用插件:
    
    module.exports = {
      plugins: [
        require('./my-plugin.js')
      ]
    }
    
    // 使用来自依赖的插件
    一个插件可以在以 vuepress-plugin-xxx 的形式发布到 npm,你可以这样使用它:
    
    module.exports = {
      plugins: [ 'vuepress-plugin-xx' ]
    }

    // 开发插件
    一个插件应该导出一个普通的 JavaScript 对象(#1),如果插件需要接受配置选项,那么它可以是一个返回对象的函数(#2),这个函数接受插件的配置选项为第一个参数、包含编译期上下文的 ctx 对象作为第二个参数。
    
    // #1
    module.exports = {
       // ...
    }
    
    // #2
    module.exports = (options, ctx) => {
       return {
          // ...
       }
    }
    
    // TIP
    一个 VuePress 插件应该是一个 CommonJS 模块,因为 VuePress 插件运行在 Node 端。

     

     推荐:https://www.yuque.com/vuepress/vuepress-plugin-yuque/intro

  • 相关阅读:
    高性能分布式计算与存储系统设计概要
    .NET核心代码保护策略
    Web 通信 之 长连接、长轮询(long polling)
    C++数据结构之二叉查找树(BST)
    T4:T4 笔记 + Trait 示例
    腾讯2014软件开发
    CSS选择器从右向左的匹配规则
    Js面向对象编程
    Js杂谈-正则的测试与回溯次数
    Microsoft Message Analyzer (微软消息分析器,“网络抓包工具
  • 原文地址:https://www.cnblogs.com/slightFly/p/12635400.html
Copyright © 2011-2022 走看看