Skip to content

Latest commit

 

History

History
44 lines (19 loc) · 1.31 KB

README.md

File metadata and controls

44 lines (19 loc) · 1.31 KB

Welcome to Free Software Magazine!

What you see here is the full repository of articles in Free Software Magazine.

They are all stored in Markdown format, with some extra FSM-specific tags for images, textboxes and zooms.

Once you clone the repository, you can create a fully working site using ryver, which will convert the "source" site into the proper final site.

The actual commands

$ sudo npm install -g ryver
$ git clone https://github.com/mercmobily/freesoftwaremagazine.git src
$ mkdir _site
$ ryver src _site

That's it! Now, under _site you have the fully functional web site.

Wait, what on earth is Ryver?!?

Think of Ryver as Jekyll on steroids. It's a custom-written static site generator build to support all of Free Software Magazine's needs:

  • Tags
  • Categories
  • Customisation to support extra tags
  • ...and more

I looked and looked, before writing my own generator, hoping that I would be able to find something able to convert Free Software Magazine, but in the end I had to give in.

Let us know if it works!

!Let us know if it works. And... don't forget to submit pull requests for Issue #1!