This repository has been archived on 2024-10-22. You can view files and clone it, but cannot push or open issues or pull requests.
spacemacs/layers/+web-services/confluence
syl20bnr ebe4c60264 Revert "Defer packages by default using use-package-always-defer"
This reverts commit 29c78ce841 and all other fixes
that have been made afterwards.

The motivation is that use-package is seen by many as a replacement for
`require`. Is use-package always defer the loading of packages then is breaks
this use case, this does not respect POLA so even if it was making Spacemacs
loading faster (up to 3s faster on some startup on my machine) we just cannot
use it, it would be irresponsible. Spacemacs should be easy to use, loading
performance will come with time but it is not a priority.
2018-03-03 23:40:10 -05:00
..
img
funcs.el Happy New Year 2018! 2018-01-04 02:00:25 -05:00
packages.el Revert "Defer packages by default using use-package-always-defer" 2018-03-03 23:40:10 -05:00
README.org

Confluence layer

/TakeV/spacemacs/media/commit/862e81e49aefd6689e9d92a150212ac46ec66e99/layers/+web-services/confluence/img/confluence.png

Description

This layer adds support for Atlassian Confluence.

Features:

  • Creating/editing of Confluence pages
  • Exporting of org buffers to Confluence wiki format

Install

Layer

To use this configuration layer, add it to your ~/.spacemacs. You will need to add confluence to the existing dotspacemacs-configuration-layers list in this file.

Configuration

Define the variable confluence-url to point on your Confluence server xmlrpc endpoint.

(setq confluence-url "https://<host>/confluence/rpc/xmlrpc")

To be able to convert from xml format to the wiki format you need to install the tool xsltproc.

About xlm and wiki formats

In confluence version 4.0, Atlassian decided to change the wiki format. They did away with the wiki format and changed the internal document format to xml.

By default the new xml format is used to edit the files. You can convert a Confluence page buffer to wiki format with SPC m TAB, it will be automatically converted back to xml before sending it to the server.

Note that xml to wiki conversion is not 100% accurate.

Although it is not recommended you can set the variable confluence-xml-convert-to-wiki-on-load to t in order to automatically convert xml content to wiki content on page load.

Key bindings

Confluence page

Key Binding Description
SPC m TAB toggle the content type to wiki format or xml format
SPC m s save the buffer on the confluence server as a minor edit
SPC m S save the buffer on the confluence server as a major edit

Org

Key Binding Description
SPC m e c in a org buffer, export the buffer to Confluence wiki format