My personal website is done using Emacs org-mode as a sort of wiki syntax. I always liked the idea of having my web written in a wiki, but I don’t like the usual wikis, with Edit buttons, and a lot of stuff that reveals that your web is actually a wiki.
My first attempt included writing my own wiki engine in Python, based on the Creole wiki syntax (I was going to call it Piripiwiki), and also adapting Ikiwiki, that has become popular among Debian developers and geeks alike. However, I could not resist the beauty of doing web publishing just with Emacs, and I finally chose org-mode above any other option.
Org-mode has lots of documentations, tutorials, even a Google Talk. But I found it difficult to set everything up for web publishing. Because of that, I have done this little package, that includes a template, a nice CSS stylesheet and a makefile to run everything very easily. Just edit the file publish_config.el, because you need to indicate the directories where your web is, and the Makefile, because as well as generating HTML, it can also upload everything automatically, using scp. Just set the host name and target directory (and maybe also username and/or password). If you want just to obtain HTML, do make html. If you want to get rid of the HTML output and other intermediate files, do make clean. To generate HTML and upload, just do make.
The first time you generate and upload your web, it will upload everything. The next time you change something, it will only re-generate and upload what has been changed since the last change, so you don’t waste bandwidth uploading stuff that is already in your web.
There is a header/header.org file that contains common code for all the pages. It includes a links bar, and a HTML macro to include common HTML code that must be in every page. I use that for the Google Analytics Javascript, to count the visits to my web.
I maintain these sources in a personal Git repository, but it is only to keep track of all the history of my web, and to get my personal sources in other computers easily. You do not need any kind of version control to get the “upload changes only” feature that I mention above.
To get everything running, you have to install both Emacs and org-mode. It has been tested with Emacs 22 and the latest available version of org-mode. I am not sure whether it will work with every combination. If you find any problem, just drop a comment here or e-mail me.
For the lazy ones who did not read the post, here is again the link to the template:
Disculpa, los comentarios están cerrados.