This site is built by Muse. It is a publishing tool using very simple Mark-Up language to generate output files in different formats like HTML, PDF and etc. It is bound to Emacs and is very handy if you want to keep some corss-linked notes with a simple style.
Muse can be regarded as the advanced version of Emacs-Wiki. They are both elisp plug-ins for emacs. Refer to Muse Homepage for more information on installation and writing with Muse.
Visit Emacs-Wiki Homepage for additional tips. (note that Emacs-Wiki is not "The Emacs Wiki", Emacs-Wiki is more a wiki-like publishing tool and personal information manager than a real wiki, because users from the web cannot edit the pages. emacs-wiki.el allows you to create a wiki on your local system and export HTML pages, in its basic configuration.)
Quickly Start a Website Using Muse
- Download release version of Muse from Muse Homepage, unzip it.
- write up a elisp script, say .muse.el:
(add-to-list 'load-path "~/muse/lisp")
;; "~/muse" is the path where Muse is located
(require 'muse-mode)
(require 'muse-html)
(require 'muse-project)
(setq muse-project-alist
'(("Home"
("~/mymuse" :default "index")
(:base "html" :path "~/html"))))
;; the name for your website is "Home"
;; the Muse files will be stored in "~/mymuse"
;; Muse will put the generated HTML files in ~/html
(setq muse-html-style-sheet "<link rel=\"stylesheet\"
type=\"text/css\"
href=\"main.css\"/>")
;; "main.css" is the stylesheet for your webpages
(setq muse-html-header "~/html/header.html")
(setq muse-html-footer "~/html/footer.html")
;; "header.html" and "footer.html" are header and footer,
;; muse will insert them before and after the generated HTML
- add a line in your ~/.emacs file to load the previous script:
(load "~/.muse.el")
- Now start writing by Emacs. Open an empty file in your muse file directory as you have set in the previous script.
- After you finish writing, save the file and press C-c C-p, the file will be published to HTML. Check it out with your Browser. For more muse hot-keys, refer to Muse Homepage. Some useful ones are: C-c C-a, list all muse files; C-c C-f, open a specific muse file.
- To customize the webpage style (fonts, decorations, etc.), you can play with .css stylesheet. To quickly learn some css grammars, go to CSS Website.
- To add some menus, sidebars, signatures, you can play with header and footer HTML files.
