Giter Club home page Giter Club logo

org-octopress's Introduction

Org-octopress – org-mode in octopress.

http://melpa.org/packages/org-octopress-badge.svg

What is Org-octopress?

Org-octopress is a package to help users those who want to write blog articles in org-style using Octopress (or Jekyll).

Note: This package is compatible with the upcoming org 8.0 system. (aka New Exporter)

Requirements

Necessary packages:

orglue
Add some functionality to org-mode. https://github.com/yoshinari-nomura/orglue
emacs-ctable
Table Component for elisp https://github.com/kiwanami/emacs-ctable

Recommended packages:

epic
Evernote Picker for Cocoa Emacs (Mac user Only) https://github.com/yoshinari-nomura/epic

How Org-octopress works?

Assumed directory tree:

+ octopress
  + source
    + blog   <- (1) You compose YYYY-MM-DD-title.org
    + _posts <- (2) ox-jekyll.el exports to YYYY-MM-DD-title.html (w/ YAML)
  + public
    + blog   <- (3) Jekyll exports to YYYY-MM-DD-title.html (w/o YAML).

If you have some pictures to be included in your articles, I recommend you to locate them at a sub-directory of blog/. It’ll nice to maintain the relative position with article files.

In this work flow, YYYY-MM-DD-title.org will be also published to your web site. If you want to hide the original Org files, you will have to setup Octopress publish settings to exclude org files in your blog/ directory.

Basic Settings

Emacs Settings:

(require 'org-octopress)
(setq org-octopress-directory-top       "~/octopress/source")
(setq org-octopress-directory-posts     "~/octopress/source/_posts")
(setq org-octopress-directory-org-top   "~/octopress/source")
(setq org-octopress-directory-org-posts "~/octopress/source/blog")
(setq org-octopress-setup-file          "~/org-sty/setupfile.org")

Octopress Settings:

In octopress/_config.yml, you must set the permelink attribute:

permalink: /blog/:year-:month-:day-:title.html

How to use

  1. M-x org-octopress
  2. Compose YYYY-MM-DD-title.org in source/blog directory.
  3. C-c C-e (org-export-dispatch) and type “P” “x” “octopress”
  4. In command line terminal:
    rake preview
        

    (see Octopress Documentation - Octopress for details)

  5. Check your article in browser.

Contact Info

The updated version might be available from: http://github.com/yoshinari-nomura/org-octopress

org-octopress's People

Contributors

egh avatar ivoscc avatar justin808 avatar sven-- avatar webframp avatar yoshinari-nomura avatar zilongshanren avatar

Watchers

 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.