org2web is the new name of org-webpage, the reason of renaming org-webpage to org2web is: https://github.com/purcell/package-lint/issues/75
org2web is a static site generator based on org-mode, which code derived from Kelvin H's org-page.
The main differents of two projects are as follow:
org2web's core don't hard code git, its process is like below:
[ Org files in repository] [ Website project configure ]
| |
< Export > < Generate >
| |
[ HTML files ] [ Uploader ] <- ( Uploader is a bash script )
| |
| |
+-------------+-------------+
|
|
< Run Uploader > <- ( For example: git uploader, rclone uploader or others )
|
|
[ REMOTE ]
org2web's default config is `org-publish-project-alist' style alist, which can manage multi-site configs in an emacs session easily.
org-website find theme-files from a themes-list in sequence and same theme-file first found will be used. User can set fallback theme with the help of this feature.
org-website include a tiny emacs web server, which can be used to test publish.
org-website can use other uploaders to upload website, for example: rclone.
…
org2web is now available from the famous emacs package repo melpa so the recommended way is to install it through emacs package management system. For more info about installation, please see tips.org in the "doc" folder.
org2web use variable `org2web-projects' to store all projects's configures, user can add a project with the help of `add-to-list' function, but the easiest way is using `org2web-add-project' function.
The follow code is my website's config, you can adjust and paste it to your .emacs
file:
(add-to-list 'load-path "path/to/org2web") ; Only needed if you install org2web manually
(require 'org2web)
(org2web-add-project
'("tumashu.github.com"
:repository-directory "~/project/emacs-packages/tumashu.github.com"
:remote (git "https://github.com/tumashu/tumashu.github.com.git" "master")
;; you can use `rclone` with `:remote (rclone "remote-name" "/remote/path/location")` instead.
:site-domain "http://tumashu.github.com/"
:site-main-title "Tumashu 的个人小站"
:site-sub-title "(九天十地,太上忘情!!!)"
:theme (worg)
:source-browse-url ("Github" "https://github.com/tumashu/tumashu.github.com")
:personal-avatar "/media/img/horse.jpg"
:personal-duoshuo-shortname "tumashu-website"
:web-server-port 7654))
pyim 's org2web config is a more complex example.
You can find more config options and theirs default values by commands:
C-h v org2web-projects
C-h v org2web-config-fallback
M-x org2web-publish
M-x org-version <RET>
to make sure you org mode version is not less than 8.0Converted from org2web.el by el2org .