Detailed explanation of the steps to build a personal blog using VuePress (with code)

This time I will bring you a detailed explanation of the steps to use VuePress to build a personal blog (with code), and what are the precautions for using VuePress to build a personal blog. The following is a practical case, let's take a look.

VuePress

##vuepress was released by Youda on April 12 A brand new static website generator based on Vue is actually a Vue spa application with built-in webpack, which can be used to write documents.

A static site generator based on Vue SSR. The original purpose is to write documents happily, but I found that it is also very good for blogging.

This is the official document of VuePress

Get started building

You can follow the examples in the document and play with it yourself. However, since VuePress documentation is also implemented using VuePress, I took a trick and directly used the docs directory in the VuePress warehouse to play with it.

1. First install VuePress globally

npm install -g vuepress

2. Then clone the VuePress repository to your computer

git clone git@github.com:docschina/vuepress.git

Execute in the docs file (please make sure your Node.js version >= 8)

When you see this line, it means you have succeeded:

Next we open http://localhost:8080/

and find that the vuepress document is actually opened:

The following work is to replace the data, but we should first look at the

directory structure of docs:

The document is divided into two For some parts, Chinese documents are in the /zh/ directory, and English documents are in the root directory.

In fact, the things in the directory are quite easy to understand. First of all, the three directories guide, default-theme-config, and config are the main contents of the Vuepress document. From the Chinese document, we can also see that only These three directories were replaced.

Home page configuration

The default theme provides a home page layout. To use it, you need to set the YAML front of README.md in your root directory Specify home: true in matter and add some other metadata.

Let’s take a look at the README in the root directory first, md:

I really can’t understand it. The official website has more detailed configuration instructions than me.

Navigation configuration

The navigation configuration file is in .vuepress/config.js

In the navigation configuration file nav is To control the navigation bar link, you can change it to your own blog directory.

The remaining default theme configuration official documents have very detailed

Documentation descriptionI won’t go into details here.

Change the default theme color

You can create an override.styl file in the .vuepress/ directory.

vuepress provides four changeable colors:

I changed it to this:

Implementation of Sidebar

Since there are many people asking in the comment area, I will update it here. In fact, no matter how detailed I write here, it is not as good as everyone reading the official document. .

The configuration of the sidebar is also in .vuepress/config.js:

Corresponding document structure:

My blog: brownhu

Deployment

After configuring your blog, execute the command line:

Vuepress build

When you see this line, it means success:

Success! Generated static files in vuepress.

will be packaged Upload the good vuepress directory to your github repository, and cooperate with github page to configure your blog website.

I believe you have mastered the method after reading the case in this article. For more exciting information, please pay attention to other related articles on the php Chinese website!

Recommended reading:

Detailed explanation of the steps for Vue to implement mobile WeChat public account

jQuery steps to implement clicking on the title text to switch fonts Detailed explanation

The above is the detailed content of Detailed explanation of the steps to build a personal blog using VuePress (with code). For more information, please follow other related articles on the PHP Chinese website!