Share an org buffer as an accessible web page with your own public domain.
- Domain
- Hosting: It is recommended to use a server with SSH access.
Add in your init.el
.
(use-package org-share-to-web
:straight (:host github :repo "tanrax/org-share-to-web.el" :files ("org-share-to-web.el"))
:ensure t)
Configure the domain to be used to access the file share and the directory where it will be hosted using TRAMP.
(setq org-share-to-web-domain "") ; Domain
(setq org-share-to-web-directory "") ; TRAMP path
Example.
(setq org-share-to-web-domain "https://mydomain.com/")
(setq org-share-to-web-directory "/ssh:[email protected]:~/www/")
The domain must end with /
. The directory must end with /
and start with /ssh:
or another TRAMP method.
Open an Org file and run org-share-to-web-buffer
.
It will copy the URL to your clipboard to open the document share.
If you need to manage the shared files, such as deleting them, use org-share-to-web-dired
.
If you want it to look really nice, include the following lines at the beginning of your Org documents.
#+html_head: <link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Lora:wght@500&display=swap">
#+html_head: <link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Inconsolata&display=swap">
#+html_head: <link rel="stylesheet" href="https://cdn.jsdelivr.net/gh/tanrax/org-share-to-web.el@main/themes/light.css">
#+OPTIONS: toc:nil num:nil html-postamble:nil
#+TITLE: My title
#+html_head: <link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Lora:wght@500&display=swap">
#+html_head: <link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Inconsolata&display=swap">
#+html_head: <link rel="stylesheet" href="https://cdn.jsdelivr.net/gh/tanrax/org-share-to-web.el@main/themes/dark.css">
#+OPTIONS: toc:nil num:nil html-postamble:nil
#+TITLE: My title