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

generator-project-journal

v0.1.3

Published

A Yeoman generator to make a journal-styled Jekyll blog.

Downloads

20

Readme

generator-project-journal Build Status

This is a Yeoman generator for a very basic Jekyll blog with a journal styling. Perfect for your basic development journal if you like to give updates to your project development on a regular basis.

Getting Started

What is Yeoman?

Trick question. It's not a thing. It's this guy:

This guy!

Basically, he wears a top hat, lives in your computer, and waits for you to tell him what kind of application you wish to create.

Not every new computer comes with a Yeoman pre-installed. He lives in the npm package repository. You only have to ask for him once, then he packs up and moves into your hard drive. Make sure you clean up, he likes new and shiny things.

npm install -g yo

Yeoman Generators

Yeoman travels light. He didn't pack any generators when he moved in. You can think of a generator like a plug-in. You get to choose what type of application you wish to create, such as a Backbone application or even a Chrome extension.

To install generator-project-journal from npm, run:

npm install -g generator-project-journal

After installing the generator, you now have two generators in your disposal to immediately churn out the appropriate Jekyll instantiation.

project-journal:app

The app generator can be accessed like so:

yo project-journal

This will scaffold out a Jekyll blog, installs the Gem bundle for you, and if you allow it, initialize a Git repo and pushes it straight away to your GitHub remote.

project-journal:post

There is another subgenerator that project-journal packs on, which is the post subgenerator. Run it like so:

yo project-journal:post

This will scaffold out a Jekyll blog post with the necessary front matter (title, date, and category) for you. The only thing you need to write is just the content!

Getting To Know Yeoman

Yeoman has a heart of gold. He's a person with feelings and opinions, but he's very easy to work with. If you think he's too opinionated, he can be easily convinced.

If you'd like to get to know Yeoman better and meet some of his friends, Grunt and Bower, check out the complete Getting Started Guide.

Development

With the Jekyll blog set up, you can run a local development session by running:

bundle exec jekyll serve -b ""

What this does is serving your Jekyll blog on your local machine, by default accessible in 127.0.0.1:4000. The -b argument sets the base path to nothing — the inital value was the repository gh-pages URL or your custom domain. With this you can access the blog on your local machine, and without tampering the _config.yml over and over again when you want to deploy or develop locally.

Contributing

If you found any bugs you can report them to the Issue page of the GitHub repository.

If you're submitting pull requests, please make sure the code you contribute follows the editorconfig settings and adheres in jshint lintings. Make sure there are tests for the behavior as well.

Why Make This Generator?

I made this generator initially for my college mates who wanted to set up a Jekyll blog for their projects on a specific class (that I took with them as well). Rather than copying a base from a commit reference of my own blog, might as well write a Yeoman generator for it. This is my first attempt in making a Yeoman generator and making tests for it as well. Hopefully I did well.

License

MIT