That Stuff I Found Along the Way

spacemacs+org-page

Note: I took a good portion of this from here. However, I felt some more details needed to be added.

Installing org-page:

First thing to do is to add org-page to the additional-packages portion of your .spacemacs file

(org-page :location (recipe
                      :fetcher github
                      :repo "sillykelvin/org-page"
                      :files ("*.el" "doc" "themes")))

Next add the following to the user-config portion of your .spacemacs file

(require 'org-page)
(setq op/repository-directory "/path/to/your/repo")
(setq op/site-domain "https://githubuser.github.io")
(setq op/personal-github-link "https://github.com/githubuser")
(setq op/site-main-title "TITLE")
(setq op/site-sub-title "SUBTITLE")
(setq user-full-name "YOUR NAME")  ;; not org-page specific
(setq user-mail-address "your@email.com")  ;; not org-page specific

Create Your Repo:

Create your github.io page using the following directions.

Then run SPC SPC op/new-repository and specify the location you want for your repo. This should probably be the same as what you put in your .spacemacs file.

In this same location you will want to add the remote, which can be done using magit. For me the easiest way to do this is through magit-status (SPC g s) and while in magit-status type M a. From there you can just follow the prompts to add your remote.

Create Your First Blog Post:

This is as simple as SPC SPC op/new-post and following the prompts.

Publish Your Page:

This should be as simple as SPC SPC op/do-publication and following the prompts, which is likely to result in you pushing y n y y.

Comments

comments powered by Disqus