Share an Org buffer as a web page. In addition, a URL will be created that you can share to view it.
Go to file
2023-06-27 07:16:08 +00:00
.github/workflows Update compile.yml 2023-06-26 14:10:38 +02:00
themes updated on - Tue Jun 27 07:16:08 UTC 2023 2023-06-27 07:16:08 +00:00
demo.gif Add demo 2023-06-19 16:02:33 +02:00
org-share-to-web.el Fix upload buffer 2023-06-20 15:06:01 +02:00
README.md Update README.md 2023-06-26 14:22:58 +02:00

Share an Org buffer as a web page. In addition, a URL will be created that you can share to view it.

Demo

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.

(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.

(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: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

#+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
#+OPTIONS: html-postamble:nil