npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

blogophon

v3.0.1

Published

A Static Site Generator supporting Markdown, responsive images, RSS and other RESTable files. Built with Node.js and minimal dependencies.

Downloads

7

Readme

Blogophon

A Static Site Generator supporting Markdown, responsive images, RSS and other RESTful files. Built with Node.js and minimal dependencies.

A live example of this blog generator can be found at 3960! Journal.

Features

  • The Blogophon generates static HTML files from Markdown articles. These HTML files can be synchronized to remote servers and are fully independent of the Blogophon generator.
  • It uses simple, fast and hackable templating via Mustache. It also supports multiple themes.
  • Generates a bunch of ways to find your articles: Regular index pages, tag pages, author pages.
  • The Blogophon comes with a built-in image-scaler for responsive images.
  • The default theme puts all relevant meta stuff into <head> for SEO and social sharing (via schema.org and OpenGraph) as well as the IndieWeb.
  • A ton of special features like RSS/ATOM newsfeeds, Accelerated Mobile Pages (AMP), Progressive Web App (PWA), Facebook Instant Articles, sending Webmentions, Gopher-support etc.
  • As the Blogophon only consists of static pages, there is no personal data (cookies, etc.) aggregated by your blog - therefore it is easy to comply with any form of privacy protection law (like the GDPR).

Requirements

The Blogophon generator works on every platform with NodeJs. This includes Windows, Mac OSX and Linux. The Blogophon can also be installed directly on your web host, as long as you have NodeJs installed on your web host and SSH access. The Blogophon generators generates your blog pages.

Your generated blog pages are independent of the Blogophon software, and can be hosted on any web hosting service - it only consists of static files. You will need no PHP, MySQL or anything like that.

Installation

  1. Make sure you have Node.js with at least version 6 installed. Call node -v to see your current version.
  2. Make sure you have ImageMagick installed. Call magick -version to see your current version. ImageMagick is needed for scaling images.
  3. Run npm install -g blogophon to install the Blogophon. If you do not have Node version 6 but at least Node version 4, install Blogophon 1.3.0 by calling npm install -g [email protected].
  4. Change to a folder you want to initialize a Blogophon blog project in.
  5. Run blogophon to start the configuration dialogue and enable special features.
  6. Set your web server's document root folder to htdocs of your Blogophon blog project (as this will be the folder where the HTML files will be generated by the Blogophon Generator).

How it works

Just call blogophon to open the Blogophon command menu in the folder you are in. There you will be able to create, edit, generate and publish Markdown articles.

The basic work-flow is this:

  1. Create a Markdown article (see Blogophon's Markdown reference on details).
  2. Generate HTML files from your Markdown article via the Blogophon generator.
  3. Optional: Publish your HTML files to a remote server.

The main menu in action.

If you are a CLI wizard, you may also want to take a look at Blogophon's special CLI features.

Update

  1. To find out if your Blogophon needs updating, run npm outdated -g blogophon.
  2. Run npm update -g blogophon to update your local Blogophon installation to the latest stable release.

Feedback

In case of issues or suggestions for the Blogophon consider using Blogophon's issue board.

Status

npm version Build Status Dependency Status devDependency Status

Legal stuff

Author: Frank Boës

Copyright & license: See LICENSE.txt