技术标签: 部署
这类静态网站生成器,还有个漂亮的名字叫 JAMStack
JAM 是 JavaScript、API 和 Markup(标记语言) 的首字母组合。
Stack (栈)表示技术栈的意思。
本质上是一种胖前端,通过调用各种 API 来实现更多的功能。
其实也是一种前后端的模式,只不过前后端分的非常明显,是一个完全的纯客户端应用。
甚至后端可以来自多个不同的厂商。
Gridsome 一个免费、开源、基于 Vue.js 技术栈的静态网站生成器。
使用 Gridsome 需要有一定的 Vue 基础,如果有基础,看过文档,只会觉得它比 Vue 本身更简单一些。
使用 Gridsome 创建的项目依赖一个特殊的第三方模块 sharp。
sharp 的作用是用来处理图片,例如压缩图片大小、转换图片格式等。
这个包很难安装成功,主要原因有两点:
sharp 官网 chinese-mirror 提供了 国内的镜像地址,其实就是 taobao 的镜像源。
# 配置 sharp 镜像地址
npm config set sharp_binary_host "https://npm.taobao.org/mirrors/sharp"
# 配置 sharp-libvips 镜像地址
npm config set sharp_libvips_binary_host "https://npm.taobao.org/mirrors/sharp-libvips"
安装 node-gyp 以及相关的编译套件。
首先全局安装 node-gyp:
npm i -g node-gyp
安装后还不能正常使用,需要安装对应的编译套件,每个操作系统需要的编译套件不同,具体按照文档中安装即可。
任何操作系统,都需要安装 Python。
以windows为例:
以管理员身份打开命令行执行 npm i -g windows-build-tools
安装后,它会自动下载安装 python 和其他工具。
windows-build-tools 的安装报错问题(我在Issues的留言):
反复执行后,通过控制面板查看已安装的程序,确实新增了几个。
查看它的安装路径 : C:\Users\[用户名]\.windows-build-tools
。
发现vs_BuildTools.exe
已经存在。
也就当命令执行到Starting installation...
,vs_BuildTools.exe
已经下载到完并开始工作。
手动打开它安装 Visual Studio 15 生成工具 2017(勾选Visual C++生成工具)。
(这个工具好像有1GB多,需要一段时间)
安装成功后,继续使用 Gridsome 创建项目,项目依赖可以安装成功。
所以我猜测命令行中执行失败可能是因为软件太大导致。
# 全局安装 gridsome
npm i -g @gridsome/cli
# 创建项目
gridsome create my-gridsome-site
# 创建项目会从 github 获取模板,并执行依赖安装
# > Clone https://github.com/gridsome/gridsome-starter-default.git 3.86s
# > Update project package.json 0.01s
# > Install dependencies
# 安装过程不显示进度,可以 ctrl+c 中断
# 然后cd进入项目目录,手动 npm i (注意删除不完整的node_modules)
# ctrl + c
# npm i
# 运行开发环境 访问 http://localhost:8080/
npm run develop
Gridsome 会将 pages 目录下的组件生成路由页面,渲染到页面中。
执行命令 npm run build
,生成静态页面。
生成结果存放在 /dist
目录下。
除了首页直接生成了 index.html
,其他页面的 index.html
都在对应的目录下,例如about/index.html
。
现在 dist
就可以部署在任何支持静态文件的web服务器中。
本地运行可以使用 serve
:
npm i -g serve
serve dist
此时访问的页面内容,是本地服务端直接获取静态html文件的内容并返回的,不是服务端渲染的。
但是页面中的交互,如点击链接跳转页面,还是客户端负责的。
手动刷新页面也是服务端直接返回的html文件内容。
这就是 Gridsome 预渲染的功能。
注意:npm run develop 启动的页面都是动态获取的,没有实时编译页面内容,只用于开发环境。
初始项目目录结构:
<static-query>
标签,专门用来查询 GraphQL 数据,提供给组件使用。dist
中。修改配置文件(gridsome.config.js)需要重新启动才能生效。
titleTemplate
中使用%s - <siteName>
g-link
dist
Pages 负责在URL上显示您的数据。 每个页面将静态生成,并具有自己的带有标记的index.html文件。
有两种方式创建 Pages 页面:
src/pages目录中的SFC单文件组件将自动具有其自己的URL。 文件位置用于生成URL,以下是一些基本示例:
src/pages/Index.vue
生成/
首页src/pages/AboutUs.vue
生成/about-us/
src/pages/about/Vision.vue
生成/about/vision/
src/pages/blog/Index.vue
生成/blog/
注意:生成的URL会将大写字母和驼峰格式转化为小写的 kebab-case 格式
src/pages 中的页面通常用于诸如 /about/ 之类的固定URL,或用于在 /blog/ 中列出博客文章。
gridsome.server.js 配置文件中提供一个 createPage 方法用于创建路由页面:
module.exports = function (api) {
api.createPages(({
createPage }) => {
createPage({
path: '/my-page', // 页面地址
component: './src/templates/MyPage.vue' // 路由组件地址
})
})
}
配置完需要重启服务。
Gridsome 也可以像 NuxtJS 一样创建动态路由,方式有:
动态页面用于客户端路由。路由参数可以通过方括号将名称包装在文件和目录名称中。例如:
src/pages/user/[id].vue
生成/user/:id
src/pages/user/[id]/settings.vue
生成/user/:id/settings
开发时不会生成静态页面,所以访问是正常的。
但是构建时,这将生成 user/_id.html
和 user/_id/settings.html
,必须具有重写规则才能使其正常访问,否则会返回 404。
动态路由的页面优先级低于静态路由。例如有一个 /user/create 的路由 和 /user/:id 路由,当id=create时,将优先 /user/create
Gridsome 打包构建时无法为动态路由的每种可能的变体生成 HTML 文件(集合模板除外,它的路由参数是可知的)。
这意味着直接访问 URL 时可能显示 404 页面。
实际情况是,Gridsome 会生成一个 HTML 文件,该文件可用于重写规则(rewrite)。
例如,/user/:id
的路由将生成 /user/_id.html
文件。
开发者可以编写rewrite规则,将所有与 /user/:id
匹配的路径映射到该文件。
官方文档没有详细介绍如何使用…
// gridsome.server.js
module.exports = function (api) {
api.afterBuild ({
redirects }) {
for (const rule of redirects) {
// rule 包含3个成员:
// rule.from - The dynamic path eg:`/user:id`
// rule.to - The HTML file path eg:`/user/_id.html`
// rule.status - 200 if rewrite rule eg:200
}
}
}
同vue路由规则一样:
module.exports = function (api) {
api.createPages(({
createPage }) => {
createPage({
path: '/user/:id(\\d+)', // (\\d+)是用正则对参数格式的限定
component: './src/templates/User.vue'
})
})
}
Gridsome 使用 vue-meta 处理关于页面的 meta 信息。
在页面组件文件中配置metaInfo选项:
export default {
metaInfo: {
title: 'User用户',
meta: [
{
name: 'author', content: 'John Doe'}
]
}
}
手动创建 src/pages/404.vue
页面组件,可以自定义404页面。
始终使用 mounted 钩子获取客户端数据。在 created 钩子中获取数据会导致问题,因为它是在生成静态HTML时执行的。
客户端动态获取的数据,在打包生成静态页面时不会预渲染到页面中。
例如,在 created 钩子中请求 API 获取数据。
如果这类动态数据,也想要预渲染到页面中,生成静态页面,就需要用到 Gridsome 中的 Collections (集合)。
Collections 用于预渲染动态数据:
通过封装好的插件,把外部数据集成到 Gridsome 中去使用。
例如官方文档中的 @gridsome/wordpress
,用于把你的 wordpress 网站中的数据集成到 gridsome 中,生成集合数据。
// gridsome.config.js
module.exports = {
plugins: [
{
use: '@gridsome/source-wordpress',
options: {
baseUrl: 'YOUR_WEBSITE_URL',
typeName: 'WordPress',
}
}
]
}
可以从任何外部 API 手动创建集合。
// gridsome.server.js
const axios = require('axios')
module.exports = function (api) {
// api.loadSource 加载资源
api.loadSource(async actions => {
// 创建名为 Post 的集合
const collection = actions.addCollection('Post')
// 预请求:获取要预渲染到页面中的数据
const {
data } = await axios.get('https://api.example.com/posts')
// 向集合添加节点
// Gridsome 会根据节点的数据,创建节点的模板,生成节点的页面
for (const item of data) {
collection.addNode({
// gridsome 会自动生成id,也可以自定义覆盖
id: item.id,
title: item.title,
content: item.content
})
}
})
}
每个 Collection 会向 GraphQL schema 添加两个根字段。
这些根字段用于检索页面中的节点。
例如将集合名为 Post,在 schema 中会添加两个字段:
post
可以通过id
获取单个节点allPost
获取节点列表
- 内置一些方法,例如排序、筛选、分页等
在运行 npm run develop
时会提供3个地址:
访问 GraphQL Playground,右侧的 DOCS 弹层可以查看可用的字段。
使用 GraphQL 的查询语句查询数据:
按需获取单个节点的字段:
按需获取节点列表的字段:
节点列表的结构:
可以在页面、模板或其他组件中通过在查询语句块中使用 GraphQL 语法查询数据,在页面中使用:
在页面 Pages 或模板 Templates 中使用 <page-query>
$page
中在其他组件 Components 中使用 <static-query>
$static
中例如:
<template>
<div>
<ul>
<li v-for="edge in $page.posts.edges" :key="edge.node.id">
<g-link to="/">{
{ edge.node.title }}</g-link>
</li>
</ul>
</div>
</template>
<page-query>
query {
# 别名
posts: allPost {
edges {
node {
id
title
}
}
}
}
</page-query>
$page
和 $static
是注入到 Vue 实例的 计算属性中的:
此时页面中的动态数据就是预渲染出来的,但是在 develop 下是看不到效果的,需要打包编译,启动一个web服务去访问打包结果。
Templates 用于将集合中的节点渲染生成单个页面。
可以配置的模板选项:
src/templates/{Collection}.vue
作为模板// gridsome.config.js
module.exports = {
templates: {
// key 是集合的名称
// value 是渲染节点的路由和页面模板,可以是字符串 或 数组
// 字符串 - 路由匹配地址,默认将 `src/templates/{Collection}.vue` 作为模板
// 打包后会生成一系列的 /posts/xx/index.html,可能会生成大量静态页面,所以静态应用不适合有大量动态内容的页面
// Post: '/posts/:id',
// 数组 - 可以为集合设置多个模板
Post: [
// 默认模板
{
path: '/posts/:id',
component: './src/templates/Post.vue'
},
// 具名模板
{
name: 'detail',
path: '/posts/:id/detail',
component: './src/templates/PostDetail.vue'
}
]
}
}
给集合配置了模板后,GraphQL schema 中的节点中会有一个 path
字段,表示模板路径。
可以使用 to
获取模板其他的具名路径。
// src/Posts.vue
<template>
<Layout>
<div>
<ul>
<li v-for="edge in $page.posts.edges" :key="edge.node.id">
<g-link :to="edge.node.path">{
{ edge.node.title }}</g-link>
</li>
</ul>
</div>
</Layout>
</template>
<page-query>
query {
# 别名
posts: allPost {
edges {
node {
id
title
path(to:"detail")
}
}
}
}
</page-query>
从模板配置生成的页面,拥有节点的 id
和 path
作为查询块中的查询变量。
使用 $id
$path
接收。
// src/templates/Post.vue
<template>
<Layout>
<div>
<h2>{
{$page.post.title}}</h2>
<div>{
{$page.post.body}}</div>
</div>
</Layout>
</template>
<page-query>
# ID类型 !不能为空(参考 GraphQL Playground 中的 DOCS)
query ($id: ID!) {
post(id: $id) {
id
title
body
}
}
</page-query>
注意,它们不是路由中的参数,而是集合节点的参数 Argument:
在 metaInfo
中使用节点字段,它必须是一个返回对象的函数:
<script>
export default {
metaInfo() {
return {
title: this.$page.post.title
}
}
}
</script>
文章浏览阅读1.3k次,点赞40次,收藏19次。虽然你不能直接计算每个房间的人数,但通过马尔科夫链的蒙特卡洛方法,你可以从任意状态(房间)开始采样,并最终收敛到目标分布(人数分布)。然后,根据一个规则(假设转移概率是基于房间的人数,人数较多的房间具有较高的转移概率),你随机选择一个相邻的房间作为下一个状态。比如在巨大城堡,里面有很多房间,找到每个房间里的人数分布情况(每个房间被访问的次数),但是你不能一次进入所有的房间并计数。但是,当你重复这个过程很多次时,你会发现你更有可能停留在人数更多的房间,而在人数较少的房间停留的次数较少。_马尔科夫链期望怎么求
文章浏览阅读3.9k次。一、su命令su命令用于切换当前用户身份到其他用户身份,变更时须输入所要变更的用户帐号与密码。命令su的格式为:su [-] username1、后面可以跟 ‘-‘ 也可以不跟,普通用户su不加username时就是切换到root用户,当然root用户同样可以su到普通用户。 ‘-‘ 这个字符的作用是,加上后会初始化当前用户的各种环境变量。下面看下加‘-’和不加‘-’的区别:root用户切换到普通..._限制su root登陆
文章浏览阅读1.2k次。精通VC与Matlab联合编程(六)作者:邓科下载源代码浅析VC与MATLAB联合编程浅析VC与MATLAB联合编程浅析VC与MATLAB联合编程浅析VC与MATLAB联合编程浅析VC与MATLAB联合编程 Matlab C/C++函数库是Matlab扩展功能重要的组成部分,包含了大量的用C/C++语言重新编写的Matlab函数,主要包括初等数学函数、线形代数函数、矩阵操作函数、数值计算函数_精通vc和matlab联合编程 六
文章浏览阅读128次。在MVC2中默认并没有实现DescriptionAttribute(虽然可以找到这个属性,通过阅读MVC源码,发现并没有实现方法),这很不方便,特别是我们使用EditorForModel的时候,我们需要对字段进行简要的介绍,下面来扩展这个属性。新建类 DescriptionMetadataProvider然后重写DataAnnotationsModelMetadataPro..._asp.net mvc 模型description
文章浏览阅读1.3k次。一.概述 本篇继续探讨web应用架构,讲基于DDD风格下最初的领域模型架构,不同于DDD风格下CQRS架构,二者架构主要区别是领域层的变化。 架构的演变是从领域模型到C..._eshoponweb
文章浏览阅读2.6w次,点赞23次,收藏85次。首先说明,本人之前没用过zookeeper、kafka等,尚硅谷十几个小时的教程实在没有耐心看,现在我也不知道分区、副本之类的概念。用kafka只是听说他比RabbitMQ快,我也是昨天晚上刚使用,下文中若有讲错的地方或者我的理解与它的本质有偏差的地方请包涵。此文背景的环境是windows,linux流程也差不多。 官网下载kafka,选择Binary downloads Apache Kafka 解压在D盘下或者什么地方,注意不要放在桌面等绝对路径太长的地方 打开conf_springboot kafka
文章浏览阅读1k次。编好水晶报表代码,用的是ActiveX模式,在本机运行,第一次运行提示安装ActiveX控件,安装后,一切正常,能正常打印,但发布到网站那边运行,可能是一闪而过,连提示安装ActiveX控件也没有,甚至相关的功能图标都不能正常显示,再点"打印图标"也是没反应解决方法是: 1.先下载"PrintControl.cab" http://support.businessobjects.c_水晶报表 不能打印
文章浏览阅读1.3k次。绝大部分UC/OS-II的源码是用移植性很强的ANSI C写的。也就是说某产品可以只使用很少几个UC/OS-II调用,而另一个产品则使用了几乎所有UC/OS-II的功能,这样可以减少产品中的UC/OS-II所需的存储器空间(RAM和ROM)。UC/OS-II是为嵌入式应用而设计的,这就意味着,只要用户有固化手段(C编译、连接、下载和固化), UC/OS-II可以嵌入到用户的产品中成为产品的一部分。1998年uC/OS-II,目前的版本uC/OS -II V2.61,2.72。1.UC/OS-Ⅱ简介。_ucos
文章浏览阅读614次,点赞22次,收藏11次。大家好,本文将围绕python自动化运维需要掌握的技能展开说明,python自动化运维从入门到精通是一个很多人都想弄明白的事情,想搞清楚python自动化运维快速入门 pdf需要先了解以下几个事情。这篇文章主要介绍了一个有趣的事情,具有一定借鉴价值,需要的朋友可以参考下。希望大家阅读完这篇文章后大有收获,下面让小编带着大家一起了解一下。_运维学python该学些什么
文章浏览阅读524次。2019独角兽企业重金招聘Python工程师标准>>> ..._hotfix for msxml 4.0 service pack 2 - kb832414
文章浏览阅读546次。python和易语言的脚本哪门更实用?_易语言还是python适合辅助
文章浏览阅读134次。详解redis中的锁以及使用场景,指令,事务,分布式,命令,时间详解redis中的锁以及使用场景易采站长站,站长之家为您整理了详解redis中的锁以及使用场景的相关内容。分布式锁什么是分布式锁?分布式锁是控制分布式系统之间同步访问共享资源的一种方式。为什么要使用分布式锁? 为了保证共享资源的数据一致性。什么场景下使用分布式锁? 数据重要且要保证一致性如何实现分布式锁?主要介绍使用redis来实..._redis setnx watch