Coder Social home page Coder Social logo

louis's Introduction

Louis: Serve your blog from S3 in five minutes or less

Louis generates static blog from the command line and automatically uploads them to S3. It's dead simple to use and requires very little set up.

It uses MultiMarkdown for inputting blog posts and pages, and comes with a ready-made theme (but you can also roll your own with Mustache).

Your blog in five minutes (or less)

Here's how you get a blog going:

0. What you'll need

1. Setup

  • Go to the S3 Console and create a new bucket named after your blog's URL (e.g.: blog.example.org)

  • Install Louis:

      sudo npm install -g louis
    
  • Create a directory somewhere on your local machine—this is where you'll store your blog's source files. Then, cd into that directory and initialize your blog:

      mkdir blog.example.org
      cd blog.example.org
      louis new
      
      > Initializing directory...
      > Directory initialized. It's all yours.
    

2. Edit your configuration and create your first post

Look at the config.yaml file and change the settings as needed. The most important settings right now are under deploy. Make sure that your AWS credentials are correct.

Next, move into the posts directory and create your first post by making a new directory that reflects its title. For example:

cd posts
mkdir 'Marco\'s special soufflé recipe'
cd 'Marco\s special soufflé recipe'
louis init

You can name the directory anything you want, and use any character that your operating system allows, including accented letters and Unicode characters.

Louis will automatically attempt to guess a title and URL (called a slug) for your site; you can edit them in the meta.yaml file.

You can now use your favourite text editor to type something into document.md. You can use MultiMarkdown syntax, including images and footnotes.

3. Publish your blog

When you're done, you can publish your blog to S3 with a single command:

louis publish

Louis will automatically compile your files, upload them to S3 and even enable your bucket for public read-only access as a static Website.

When the process is complete, Louis tells you the final URL of your website:

Analyzing...
  - Analyzing post archive...
  - Analyzing the index page...
  - Analyzing RSS feed...

All documents are up to date.


Deploying website...

- Analyzing directory structures...
- Enabling website...
- Making website accessible...
- Deleting stale files...
- Syncing files...

*** -> Your site should now be accessible at http://blog.example.com.s3-website-us-east-1.amazonaws.com

Deployment complete.

More information

Louis is very new, so bugs are likely—and patches are welcome. It is also capable of much more than what is shown here—I just haven't had time for proper docs yet. Try louis --help for some ideas.

louis's People

Contributors

mtabini avatar

Watchers

James Cloos avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.