GitXplorerGitXplorer
j

hexo-admin

public
1760 stars
298 forks
73 issues

Commits

List of commits on branch master.
Verified
b31671cd351c366d5c1325e181295368faef8c07

Update Readme.md

jjaredly committed 4 years ago
Unverified
72b90d93bf87bdf0f0464b3c982fd888c720d48b

updated hexo-fs dependency, currently not working (#167)

hhughpearse committed 6 years ago
Unverified
1ec4a71b14dfbb775fb1b01a03ec1877193595e2

fix pasted image src on Windows (#160)

ppirtleshell committed 6 years ago
Unverified
da014290ed4589b011e79e1c4a166f4f757bdb69

2.3.0

jjaredly committed 7 years ago
Unverified
1cb21ccf8213cacb33756fbcfa2f70f1b1148cba

added support for arrays in custom metadata. fixes #150 (#151)

oonemenzel committed 7 years ago
Unverified
bbeb4ab88056e1caa42faba02d2748ab0616d3f5

Use the same protocol as the page served in (#148)

HHaocen committed 7 years ago

README

The README file for this repository.

Maintainer wanted!

This project has a ton of people using it, but I (@jaredly) haven't used Hexo in several years. If you use this plugin, and are interested in helping maintain it, I'd love your help! To volunteer, start making pull requests fixing bugs & making things better :) if I'm not responsive, feel free to bug me on twitter (@jaredforsyth).

logo

An admin UI for the Hexo blog engine. Based off of the Ghost interface, with inspiration from svbtle and prose.io.

Hexo Version

For 2.x, use version 0.3.0 of this plugin. Version 1.x and beyond only support Hexo v3.x.

Contents

Local use vs deployment

This plugin was originally designed as a local editor -- you run hexo locally, use hexo-admin to author posts, and then use hexo generate or hexo deploy to send the generated static HTML files up to github pages or some other static server.

However, hexo-admin can be run on your live blog, as long as you're using a non-static hosting service such as Heroku, DigitalOcean, etc. Static hosting services such as Github pages and Surge.sh does not support running hexo-admin from your live site. If you're using Hexo admin from your live blog, you should definitely set up a password (see below) -- otherwise anyone will be able to edit your content.

Screenshots

posts view

editor view

Quickstart

1. Setup hexo & create a blog

npm install -g hexo
cd ~/
hexo init my-blog
cd my-blog
npm install

2. Install the admin & start things up

npm install --save hexo-admin
hexo server -d
open http://localhost:4000/admin/

3. Profit!

The UI should be pretty discoverable -- let me know if you can't find something.

4. Password protection

If you're using Hexo admin on your live server, you want some password protection. To enable this, you just add a few config variables to your hexo _config.yml:

admin:
  username: myfavoritename
  password_hash: be121740bf988b2225a313fa1f107ca1
  secret: a secret something

The password_hash is the bcrypt hash of your password. The secret is used to make the cookies secure, so it's a good idea to have it be long and complicated.

A utility in Hexo admin's Settings can hash your password and generate the admin section for you. Start Hexo and go to Settings > Setup authentification and fill out your information. Copy the generated YAML into your _config.yml.

Once that's in place, start up your hexo server and going to /admin/ will require you to enter your password.

5. Custom post metadata

To add and edit your own post metadata with the admin interface, add the metadata variable and your custom variables to your hexo _config.yml:

metadata:
  author_id: defaultAuthorId
  language:

You can provide default values that will be used to initialize the metadata of a new post. These can be either primitives or arrays.

6. Contribute!

Credits

built with ❤ by Jared Forsyth (@jaredforsyth) using react, browserify, and less.