Skip to content

sergeyzwezdin/hexo-generator-redirect

master
Switch branches/tags
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
lib
 
 
 
 
 
 
 
 
 
 
 
 
 
 

hexo-generator-redirect Publish on NPM

hexo-generator-redirect is a plugin for Hexo static site generator that generates additional redirect pages. It's useful if you migrate your website and changed addresses for some posts.

  • Migrate to new URLs without the pain.
  • Easy to install and use.
  • Custom templates for the redirect page.

How it works

The plugin generates additional HTML page for "outdated" URLs. These pages will contain information on where the page was moved to.

Requirements

  • Hexo: 4.x
  • Node 12+

Usage

  1. Install the plugin using npm:
$ npm install hexo-generator-redirect --save-dev
  1. Add redirect_from key into frontmatter of the page:
layout: post
title: Page
redirect_from:
- /old-url1
- /old-url2
  1. Create a layout template for the redirect page (for more details see below).
  2. Build the website 🤝.

Creating the template

Create redirect.ejs in the layout folder of your theme.

You can use the post variable in the template. To access the target page information, use page.target.path.

Here is an example of the redirect page layout (redirect.ejs):

<% const newUrl = full_url_for(page.target.path) %>

<h1>Page address was changed</h1>
<p>The new page address is <a href="<%= newUrl %>"><%= newUrl %></a></p>

<script type="text/javascript">
  setTimeout(function(){ document.location.href = '<%= newUrl %>'; }, 5000);
</script>

About

Redirect pages generator for Hexo static site generator

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published