自建PHP静态网站案例,用VuePress来搭建一个极简的静态网站

最新推荐文章于 2021-12-28 17:24:22 发布

weixin_39746552

最新推荐文章于 2021-12-28 17:24:22 发布

阅读量405

点赞数

文章标签：自建PHP静态网站案例

VuePress学习

全局安装前我们需要Git和node这两个软件，关于怎么安装可以我之前hexo的视频教程

假如这两个都没有安装好，那么下面就不需要看了哈，栈友们

全局安装

首先我们先全局安装一下

npm stall -g vuepress # 或者 yarn global add vuepress

这里等待安装完成后，我们在命令行输入 vuepress或者输入vuepress -V可以看到

vuepress

Usage: vuepress [options]

Options:

-V, --version output the version number

-h, --help output usage information

Commands:

dev [options] [targetDir] start development server

build [options] [targetDir] build dir as static site

eject [targetDir] copy the default theme into .vuepress/theme for customization.

Run vuepress --help for detailed usage of given command.

vuepress -V

0.14.8

目录结构

好，安装成功后，我们先来了解一下vuepress的目录结构

首先我们先新建一个项目，项目名为 “vuepress” ，然后我们进入到这个文件夹,我们在这个文件夹的空白处右键Git Bash Here，我们会看到一个黑底的命令工具，上面的全局安装也是可以在这里来安装和查看版本号的，这里不多说了，直接输入下面的命令哈

我们先输入一行命令，生成package.json文件

npm init -y

回车后，我们可以看到

{

"name": "vpress",

"version": "1.0.0",

"description": "",

"main": "index.js",

"scripts": {

"test": "echo \"Error: no test specified\" && exit 1"

"keywords": [],

"author": "",

"license": "ISC"

}

然后你回到vuepress文件夹内，本来是空的文件夹，现在多出来一个package.json文件

开始写作

新建README.md文件

在命令框输入

echo '# Hello VuePress!' > docs/README.md

输入完后，还是回到vuepress文件夹内，我们可以看到多出来一个docs的文件夹里面有一个README.md文件，打开这个文件可以看到有Hello VuePress的字样

运行测试一下

在项目根目录的命令行输入

vuepress dev docs

VuePress dev server listening at http://localhost:8080/

我们在浏览器打开 http://localhost:8080/ 可以看到一个很简洁的页面

装饰首页

首页配置

我们来编辑一下docs目录下的README.md文件

---

home: true

heroImage: /mackxin.png

heroText: 馨客栈

tagline: 关注分享，关注导航，关注馨客栈

actionText: 每日更新 →

actionLink: /fuli/

features:

- title: 馨客栈导航

details: 以 Markdown 为中心的项目结构，以最少的配置帮助你专注于写作。

- title: 馨客栈前端导航

details: 享受 Vue + webpack 的开发体验，在 Markdown 中使用 Vue 组件，同时可以使用 Vue 来开发自定义主题。

- title: 馨客栈每日分享

details: VuePress 为每个页面预渲染生成静态的 HTML，同时在页面被加载的时候，将作为 SPA 运行。

---

我们配置完后直接到浏览器看效果，感觉是不是不一样了哈

创建配置文件

在配置之前我们先要在docs文件夹下面新建一个新的文件夹，名字为 “.vuepress”，记得前面是有个点的哦，不要忘记了。然后我们进入到这个.vuepress文件夹，再在里面新建一个config.js文件，我们的导航配置文件就是在里面配置的哈

配置favorite.icon

在.vuepress文件夹下新建public文件夹，把自己制作好的icon放进去

然后我们在config.js配置文件来操作

// .vuepress/config.js

module.exports = {

title : 'mackxin',

description : 'xininn',

base: '/', // 这是部署到github相关的配置

markdown: {

lineNumbers: false // 代码块显示行号

head : [

['link',{rel:'icon',href:'/mackxin.ico'}]

sidebar: 'auto', // 侧边栏配置

sidebarDepth: 2, // 侧边栏显示2级

}

现在重新执行命令yarn docs:dev 就可以看到效果了

导航配置

我们主要配置的也是config.js文件

module.exports = {

title : 'mackxin',

description : 'xininn',

head : [

['link',{rel:'icon',href:'/mackxin.ico'}]

themeConfig: {

nav: [

{ text: '首页', link: '/' },

{ text: '馨客栈导航', link:'http://mackxin.com/nav.html/' },

{ text: '馨客栈前端导航', link:'http://mackxin.com/webnav.html/' },

{ text: '馨客栈每日分享', link: 'http://mackxin.com/fx.html/' },

{ text: '关于', link: '/about' },

{

text: '分享',

items:[

{ text: '技术' , link:'/jishu/'},

{ text: '每日分享' , link:'/fx/'}

]

{ text: 'GitHub', link: 'https://github.com/mackxin'},

// 下拉列表显示分组

{

text: '学习',

items: [

{

text: '前端',

items: [

{ text: 'js', link: '/js/' },

{ text: 'css', link: '/css/' }

]

{

text: '后端',

items: [

{ text: 'php', link: '/php/' },

{ text: 'java', link: '/java/'},

]

}

sidebarDepth: 2,

lastUpdated: 'Last Updated'

}

这里我们要新建about、js、css、php、java、jishu、fx等七个文件夹，我们来看看新建完的目录结构哈

├─docs // docs目录下

│ ├─.vuepress //文件夹的名字

│ | ├─ public //文件夹的名字

│ | ├─logo.png

│ | ├─ config.js //配置文件

│ ├─js //文件夹的名字

│ ├─README.md //js首页文件

│ ├─css //文件夹的名字

│ ├─README.md //css首页文件

│ └─php //文件夹的名字

│ ├─README.md //php首页文件

│ └─java //文件夹的名字

│ ├─README.md //java首页文件

│ └─jishu //文件夹的名字

│ ├─README.md //技术首页文件

│ └─fx //文件夹的名字

│ ├─README.md //分享首页文件

| about.md //关于页面

| README.md //首页配置

侧边栏配置

主要配置的也是config.js文件

// .vuepress/config.js

module.exports = {

themeConfig: {

sidebar: {

'/fx/': [

'',

'fx1',

'fx2'

'/js/': [

'',

'js1',

'js2'

'/css/': [

'',

'css1',

'css2'

'/php/': [

'',

'php1',

'php2'

'/java/': [

'/java/', // JAVA文件夹的README.md 不是下拉框形式

{

title: 'java标题',

children: [

'/java/java1', // 以docs为根目录来查找文件

'/java/java2' // 以docs为根目录来查找文件

]

}

]

// 下面的是首页显示侧边栏的，不需要首页显示的话可以删掉代码

// '/': [

// '', /* / */

// 'contact', /* /contact.html */

// 'about' /* /about.html */

// ]

}

部署

这里暂时只讲部署到GitHub Pages的哈

首先我们在package.json文件里面添加代码，如下

{

"scripts": {

"docs:build": "vuepress build docs",

"d": "bash deploy.sh"

}

然后我们在vuepress文件夹下新建一个名为deploy.sh的文件，跟docs文件夹同级的哈，不要放错地方了

如果你想发布到 https://<USERNAME>.github.io ,记得吧文件里面的改成你的github的用户名哦，不然无效的哈

#!/usr/bin/env sh

# 确保脚本抛出遇到的错误

set -e

# 生成静态文件

npm run docs:build

# 进入生成的文件夹

cd docs/.vuepress/dist

# 如果是发布到自定义域名

# echo 'www.example.com' > CNAME

git init

git add -A

git commit -m 'deploy'

# 如果发布到 https://.github.io

git push -f git@github.com:/.github.io.git master

# 如果发布到 https://.github.io/

# git push -f git@github.com:/.git master:gh-pages

cd -

如果你想发布到 https://<USERNAME>.github.io/ ，记得吧文件里面的改成你的github的用户名哦，还有就是把你的改成你新建的仓库的名字哦

这里要注意一下哦

如果你想发布到 https://<USERNAME>.github.io/

那么你需要到config.js文件里面配置一下哦

base:'/vblog/'

#!/usr/bin/env sh

# 确保脚本抛出遇到的错误

set -e

# 生成静态文件

npm run docs:build

# 进入生成的文件夹

cd docs/.vuepress/dist

# 如果是发布到自定义域名

# echo 'www.example.com' > CNAME

git init

git add -A

git commit -m 'deploy'

# 如果发布到 https://.github.io

# git push -f git@github.com:/.github.io.git master

# 如果发布到 https://.github.io/

git push -f git@github.com:/.git master:gh-pages

cd -

弄好以后我们定位在 vuepress的空白处，右键git bash here

输入命令

npm run d

如果你看到的是下面的这样，那就说明你成功了哈

> vpress@1.0.0 d H:\blog\vpress

> bash deploy.sh

> vpress@1.0.0 docs:build H:\blog\vpress

> vuepress build docs

WAIT Extracting site metadata...

[15:53:56] Compiling Client

[15:53:56] Compiling Server

[15:54:35] Compiled Server in 39s

[15:54:36] Compiled Client in 40s

WAIT Rendering static HTML...

DONE Success! Generated static files in docs\.vuepress\dist.

······

这里省略好多英文

······

create mode 100644 php/php1.html

create mode 100644 php/php2.html

Enumerating objects: 56, done.

Counting objects: 100% (56/56), done.

Delta compression using up to 2 threads

Compressing objects: 100% (53/53), done.

Writing objects: 100% (56/56), 83.58 KiB | 950.00 KiB/s, done.

Total 56 (delta 30), reused 0 (delta 0)

remote: Resolving deltas: 100% (30/30), done.

To github.com:mackxin/vblog.git

* [new branch] master -> gh-pages

部署到自己的域名下

首先到你的个人域名的管理后天，进行解析我们来添加一下记录

记录类型我们选择 A 类型哈

主机记录，一个www 一个@

解析路线我们默认就好了

记录值看下面我的介绍

我的域名是mackxin.github.io ,那么我们要获得这个的ip的话我们就要ping一下

在命令行输入：ping mackxin.github.io然后回车，稍等一下，你就可以看到你的ip值了

Ping mackxin.github.io [185.199.110.153]

这里我们需要的值就是185.199.110.153了

添加 CNAME 文件

在仓库 mackxin.github.io 中找到 Settings > Custom domain 把 www.liweiwen.top 添加进去即可

最后，看到这里如果你还是没有看懂的话，那么你需要看下面的视频链接，希望可以帮到你顺利的搭建网站，上面说的所有内容都可以在下面的视频链接那里得到你想要的答案，如果看了还是不懂的话，那么你可以多看几遍

学无止境，好好努力，奋斗吧！

想看视频的记得点击下面的链接学习哈

weixin_39746552

关注

0
点赞
踩
0

收藏

觉得还不错? 一键收藏
0
评论
自建PHP静态网站案例,用VuePress来搭建一个极简的静态网站

VuePress学习全局安装前我们需要Git和node这两个软件，关于怎么安装可以我之前hexo的视频教程假如这两个都没有安装好，那么下面就不需要看了哈，栈友们全局安装首先我们先全局安装一下npm stall -g vuepress # 或者 yarn global add vuepress这里等待安装完成后，我们在命令行输入 vuepress或者输入vuepress -V可以看到vuep...
复制链接

扫一扫