Share an Org buffer as a web page. In addition, a URL will be created that you can share to view it. ![Demo](demo.gif) ## Requirements - **Domain**: To access the file share. - **Hosting**: To host the file share. It is recommended to use a server with SSH access. - **TRAMP**: To access the hosting. ## Install Add in your `init.el`. ```elisp (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 Configure the domain to be used to access the file share and the directory where it will be hosted using TRAMP. ```elisp (setq org-share-to-web-domain "") ; Domain (setq org-share-to-web-directory "") ; TRAMP path ``` Example. ```elisp (setq org-share-to-web-domain "https://mydomain.com/") (setq org-share-to-web-directory "/ssh:debian@mydomain.com:~/www/") ``` The domain must end with `/`. The directory must end with `/` and start with `/ssh:` or another TRAMP method. ## Run 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`. ## Theme If you want it to look really nice, include the following lines at the beginning of your Org documents. ### Light ```org #+html_head: #+html_head: #+html_head: #+OPTIONS: toc:nil num:nil #+OPTIONS: html-postamble:nil ``` ### Dark ```org #+html_head: #+html_head: #+html_head: #+OPTIONS: toc:nil num:nil #+OPTIONS: html-postamble:nil ```