Need help with azeroth-js?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

huytd
210 Stars 54 Forks 36 Commits 11 Opened issues

Description

:beer: Yet another Static blog engine. Built with :heart: for Github

Services available

!
?

Need anything else?

Contributors list

# 56,353
elm
Emacs
Laravel
trello
8 commits
# 43,472
Kuberne...
Amazon ...
acm
Ada
2 commits
# 510,038
HTML
CSS
2 commits
# 85,332
Bootstr...
iOS
Android
autoit
2 commits
# 196,596
Shell
OCaml
google-...
fuse
1 commit
# 612,048
CSS
HTML
1 commit
# 159,549
HTML
voice-c...
CSS
Raspber...
1 commit
# 472,968
HTML
CSS
w3c
web-sta...
1 commit
# 619,277
CSS
HTML
1 commit
# 150,479
vapor
voice-r...
iOS
React N...
1 commit
# 310,073
C
Dart
Shell
wkwebvi...
1 commit

AzerothJS

AzerothJS is an open source blog engine running on static file servers such as Github Pages or any web hosting.

In short: 100% client-side JavaScript.

Live demo

Check out the live demo here

What makes AzerothJS cool?

  • Super lightweight
  • No installation needed
  • No server side code
  • Made for Github Pages
  • Easy to customization
  • Static HTML Generator

How to use?

Run locally

  1. Clone this project to your computer
  2. Start simple HTTP server with Python:

Python2

  python -m SimpleHTTPServer 3000
Python3
  python -m http.server 3000

3. Your blog now available at http://localhost:3000

Use with Github Pages

  1. Create your Github Pages
  2. Clone this project and push it to your Github Pages
  3. Every time you want to write, create a new
    *.md
    file in
    posts
    folder and write with your favorite Markdown Editor
  4. Modify
    posts/home.md
    , list your posts here
  5. Commit and push everything here. Done!

Use with other web host

  1. Clone this project to your computer
  2. Create a new post in
    *.md
    format and save to
    posts
    folder
  3. Upload the everything to your web host
  4. Done

Two display mode

Azeroth has 2 display mode: Live Markdown and Static HTML.

If you point your browser to http://yoursite.com/#/slugged-post-name, Live Markdown mode will be used to render HTML content directly from Markdown file.

One problem of Live Markdown is: it's unable to display the content when you share the site on social networks like Facebook or Twitter. To solve this issue, we use Static HTML. After generating static HTML content, you can access your post at http://yoursite.com/posts/slugged-post-name

How to generate Static HTML

Run this script in your root folder:

node generator.js

The script will automatically convert all

*.md
files in
/posts
folder to
*.html
.

Now you can list your HTML pages in

home.md
instead of markdown files.

How to customize?

Change code highlighting theme

The original theme for the code highlighting is

Tomorrow Night
. If you don't like it, there are many pre-installed themes inside
css/highlight
folder. Pick one and replace to
line 6
of
index.html
:

Change the font family

The original font for the blog is

Roboto Slab
. You can change the new font by replacing
line 4
of
index.html
:

And change the font in

css/theme.css
:
* {
    font-family: 'Roboto Slab', serif;
    font-size: 20px;
    font-weight: 100;
}

Insert your Social links

There are some social icon links in

footer
, put your own one by edit the
index.html
:

Night Theme

Change your CSS link in both the

index.html
and
template.html
to this:
html

Google Analytics

In the end of

index.html
and
template.html
, there is a line:
ga('create', 'Insert-Your-GA-ID-Here', 'auto');

Replace

Insert-Your-GA-ID-Here
with your Google Analytics ID to start monitoring your blog.

Uhmmm, you made it, but did you use it?

Yes, I'm using it for my personal blog (http://huytd.github.io/), it's in Vietnamese.

If you prefer to read English version, Goole Translate can help (https://translate.google.com/translate?sl=auto&tl=en&js=y&prev=_t&hl=en&ie=UTF-8&u=http%3A%2F%2Fhuytd.github.io%2F&edit-text=)

License

MIT

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.