Editing 2020-01-19 Oddmuse curl exploration and setup

[[https://github.com/kensanata/oddmuse-curl oddmuse-curl]] is kensanata's (AlexSchroeder) tool to use Emacs to edit oddmuse wikis. I think it works rather well for my needs. Alternatively, I can also use the org exporter to export org mode content and manually copy this into a wiki page via the web browser. CLI options also exist to update the wiki, but I don't think I need that functionality. Borrowing off the documentation of oddmuse-curl, I was able to set this up, with some additional settings. It always helps to read the source code, and I'm finding of late that elisp code often seem to have a detailed explanation, comments and etc that make the code a pleasure to read. One always hears - keep the code well commented, and to use caution in describing the idea rather than the syntax. However, it is not often to find such examples. It is probably also worth noting that most of them also seem to prefer to not have their readme's tangling the source code. The .el files are probably edited directly in Emacs. This is not surprising because the lispy mode (and etc) provide very good support for writing lisp in Emacs. So to begin with : Clone kensanata's package from github to the desired location: {{{ git clone https://github.com/kensanata/oddmuse-curl.git ~/scimax/user/external_packages/ }}} Next here is my config. There are some additional options that kensanata's readme does not mention, however all these options can be found by reading the source code. {{{ ;; Location of the oddmuse curl library being added to the path so the functions are avialable. (add-to-list 'load-path "~/scimax-personal/external_packages/oddmuse-curl/") ;; Oddmuse user name (setq oddmuse-username "shrysr") ;; setting a lit of the oddmuse wikis that you want to connect to (setq oddmuse-wikis '(("EmacsWiki" "https://www.emacswiki.org/emacs" utf-8 "abcd" nil) ("sr" "http://testwiki.ragavan.co" utf-8 "abcd" nil))) (setq oddmuse-directory "~/my_org/01_wiki/oddmuse/") (add-to-list 'auto-mode-alist '("~/my_org/01_wiki/oddmuse" . oddmuse-mode)) (autoload 'oddmuse-edit "oddmuse-curl" "Edit a page on an Oddmuse wiki." t) (add-to-list 'vc-handled-backends 'oddmuse) (defun vc-oddmuse-registered (file) "Handle files in `oddmuse-directory'." (string-match (concat "^" (expand-file-name oddmuse-directory)) (file-name-directory file))) (require 'oddmuse-curl) ;; (oddmuse-mode-initialize) }}} All I have to do is use 'M-x oddmuse-go' to select the wiki I want and then start editing the page required. In the beginning it is a little intimidating to consider that a page has to be selected. However the search option can be easily used for anything relevant. It might also make sense to place useful links within a single page like the page which can be visited as a bookmark. Related: EmacsStuff OddmuseWiki CodeJournal

Summary:

This change is a minor edit.

Username:

Replace this text with a file