The code repo for the LFE News & Updates Blog
We welcome blog contributors! Just fork the repo, write your post, and submit a PR.
For those who will actually be executing the
make publish target,
git-subtree is required.
$ git clone email@example.com:andrewmwhite/git-subtree.git $ cd git-subtree $ sudo make install
- Fork this repo (you might want to rename yours from "blog" to "lfe-blog")
- See the usage below to create a post
- Push to your fork
- Issue a PR from your branch to lfe/blog
Get the code
- Fork us.
- Update the name in your new repo's settings
$ git clone firstname.lastname@example.org:<YOURNAME>/lfe-blog.git $ cd lfe-blog
Create a post
$ TITLE="Exciting LFE News" make new
Edit to your heart's content. Be sure to update the following:
- Category (theme of your post)
- Descriptive tags
- Your name as
Add to the repo
$ git add src/_posts/2014-12-04-1323-exciting-lfe-news.md
Also at this point you'll want to add any new directories that were created,
e.g., for tags, archives, years, etc. Make sure you didn't miss anything by
checkout the untracked files in the
git status output.
Issue a Pull Request
Once you're stasified with your post, push your branch up to your fork of
the blog and issue a PR to be merged with
master of lfe/blog.
- Merge a contributor's PR
- Regenerate the static content
- Push the updated static content to
Once a contributor's code has been merged (either in the Web UI or via
command line), you are ready to publish. This needs to be done locally,
so if I've merged a PR on Github, you'll need to
$ git pull origin master.
The following command will regenerate the static content, commit it to
master (interactively), and then push the static content to
for the LFE blog repo on github (which will be renderable immediately on
$ make publish
To create a new post:
$ TITLE="Super-Sweet LFE Tutorial" make new
This will open a draft with
vi. Edit to your heart's content, save, commit,
push, and send the PR!
Rebuild the site static files in the
$ make build
Run a local copy of the site available on http://localhost:4000, served from
$ make run
Clean up your build files:
$ make clean
Update your jekyll Ruby gem. This will also update your gems and install jekyll, if it's not already installed:
$ make update
Publish your changes to
$ make publish
*Publish your changes to staging-blog.lfe.io:
$ make staging