Skip to content

zzeitt/ox-conf

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 

Repository files navigation

org-conf

Last updated Time-stamp: <2025-02-13 18:25:45>

README

This is an org export backend that supports Confluence wiki storage format…

Prerequisites:

  • Confluene page:
    • Create one conf page on your Confluence cloud side. (Currently ox-conf.el doesn’t support creating the page from scratch, instead it updates an existing page when exporting.)
  • Org file:
    • Add #+CONF_ID and #+CONF_SPACE at the top of the .org file you want to export.
  • Emacs init:

Exporting:

  • Wake up org-export dispatch.
  • Press f f for exporting to the CONF_PAGE you provided.

Options:

  • f b: “To buffer” org-conf-export-to-buffer
  • f p: “Page info” org-conf-export-page-info
  • f i: “Image info” org-conf-export-img-info
  • f f: “To Confluence” org-conf-export-to-conf
  • f w: “To Confluence (w/o POST)” org-conf-export-to-conf-without-post
  • f r: “Forget the wrong password” org-conf-forget-password

Response:

  • Once exported successfully, yout will get PUT SUCCEED response.

Note: Most of the codes in this file are adapted from ox-html.el. Part of the codes are inspired by org-jira.el.

Change Log:

  • 2025-01-21: Initial commit.
  • 2025-02-13: Fix markup not exported as expected.

Example

Given this file: tmp.org.

#+TITLE: tmp
#+AUTHOR: John Doe
#+CONF_SPACE: xxx
#+CONF_PAGE: xxx
#+CONF_ID: xxx
#+OPTIONS: ^:{}
* Heading
Hello, world!

Run M-x org-export-dispatch f f.

References