Skip to content

A theme for org mode exports using professional web development techniques. Designed to be simple but also creative.

License

Notifications You must be signed in to change notification settings

jessekelly881/Imagine

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

27 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

What is Imagine?

Imagine is a clean and creative single page theme designed for org mode exports. It currently supports latex, code blocks, lists, and tables.

To see imagine live see: Imagine

Support my work!

Coffee in. Code out. Wanna buy me a coffee(or a beer)? Bitcoin: bc1q60twsepwkjpf8w7myaupkr2fxkuc0cze0wxygh

How to use

To use Imagine copy the imagine.css file into the folder you want to use it and them add the following headers to your org mode document:

#+HTML_HEAD: <link rel="stylesheet" type="text/css" href="imagine.css" />
#+OPTIONS: toc:nil num:nil html-style:nil

Syntax highlighting

Getting the syntax highlighting working can sometimes be a little difficult. The stylesheet targets html classes produced by org to style them. But, for this to work, we have to tell org that we want it to export to html with these classes. This can be done one of two ways. Globably, by adding the following to your org config

(setq org-html-htmlize-output-type 'css)

or to set this locally add the following to the end of your org document(than you larstvei for recomending this):

* COMMENT Local Variables
  # Local Variables:
  # org-html-htmlize-output-type: css
  # End:

Because this code is wrapped in a COMMENT header it will not be exported. This method is in fact very flexable because you can add arbitrary elisp to the document which will run whenever the document is opened(prompting you of course, but you can tell emacs to never ask again). An excelent example of this is the following code:

* COMMENT Local Variables
  # Local Variables:
  # org-html-htmlize-output-type: css
  # eval: (add-hook 'after-save-hook 'org-html-export-to-html nil t)
  # End:

Adding this to the end of the document will not only tell emacs to export the org document with the classes we need for code highlighting it will also tell emacs to export the document to html on every save. Which is SUPER useful.

Current TODO List

  • Fix type setting for code blocks
  • Fix font scaling template wide. Font sizes should not be specified in px as they do not scale.
  • Increase your font-background luminosity contrast to increace readability

About

A theme for org mode exports using professional web development techniques. Designed to be simple but also creative.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages