Skip to content

Commit

Permalink
Add a note about org loading limitation
Browse files Browse the repository at this point in the history
Add a release note about the limitation of org loading since 0.105, and
also document it in the org-layer's README.

Close syl20bnr#3277

Move note to FAQ and correct text to 0.104

(cherry picked from commit 5105b99)
  • Loading branch information
StreakyCobra authored and zv committed Dec 23, 2015
1 parent 37fcc28 commit fa962e3
Show file tree
Hide file tree
Showing 2 changed files with 14 additions and 5 deletions.
7 changes: 7 additions & 0 deletions doc/FAQ.org
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,7 @@
- [[#the-powerline-separators-have-no-anti-aliasing-what-can-i-do-][The powerline separators have no anti-aliasing, what can I do ?]]
- [[#why-is-after-init-hook-not-executed-][Why is after-init-hook not executed ?]]
- [[#what-is-the-difference-between-spacemacs-base-and-spacemacs-distributions-][What is the difference between =spacemacs-base= and =spacemacs= distributions ?]]
- [[#why-do-some-of-my-org-related-settings-cause-problems][Why do some of my =org=-related settings cause problems?]]
- [[#windows][Windows]]
- [[#why-do-the-fonts-look-crappy-on-windows-][Why do the fonts look crappy on Windows ?]]
- [[#why-is-there-no-spacemacs-logo-in-the-startup-buffer-][Why is there no Spacemacs logo in the startup buffer ?]]
Expand Down Expand Up @@ -55,6 +56,12 @@ passed =-l init.el= file.
check out the =packages.el= file in the respective folders in the
=+distribution= folder of the =layers/= directory.

*** Why do some of my =org=-related settings cause problems?
Since version 0.104, spacemacs uses the `org` version from the org ELPA
repository instead of the one shipped with emacs. Then, any `org` related code
should not be loaded before `dotspacemacs/user-config`, otherwise both versions
will be loaded and will conflict.

** Windows
*** Why do the fonts look crappy on Windows ?
You can install [[https://code.google.com/p/mactype/][MacType]] on Windows to get very nice looking fonts. It is
Expand Down
12 changes: 7 additions & 5 deletions layers/org/README.org
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,7 @@
* Table of Contents :TOC@4:
- [[#description][Description]]
- [[#features][Features:]]
- [[#note][Note]]
- [[#install][Install]]
- [[#layer][Layer]]
- [[#github-support][Github support]]
Expand Down Expand Up @@ -34,19 +35,22 @@ This layer enables [[http://orgmode.org/][org mode]] for Spacemacs.
- A [[http://pomodorotechnique.com/][pomodoro method]] integration via [[https://github.com/lolownia/org-pomodoro][org-pomodoro]]
- TODO capture via [[https://github.com/waymondo/org-repo-todo][org-repo-todo]]
- presentation mode via [[https://github.com/rlister/org-present][org-present]]
-
** Note
Since version 0.104, spacemacs uses the `org` version from the org ELPA
repository instead of the one shipped with emacs. Then, any `org` related code
should not be loaded before `dotspacemacs/user-config`, otherwise both versions
will be loaded and will conflict.

* Install

** Layer

To use this contribution add it to your =~/.spacemacs=

#+BEGIN_SRC emacs-lisp
(setq-default dotspacemacs-configuration-layers '(org))
#+END_SRC

** Github support

To install Github related extensions like [[https://github.com/larstvei/ox-gfm][ox-gfm]] to export to Github
flavored markdown set the variable =org-enable-github-support= to =t=.

Expand All @@ -57,15 +61,13 @@ flavored markdown set the variable =org-enable-github-support= to =t=.
#+END_SRC

** Gnuplot support

Org-mode support the plotting of data within tables through [[http://www.gnuplot.info/][Gnuplot]] as
demonstrated [[http://orgmode.org/worg/org-tutorials/org-plot.html][here]]; unfortunately, this is [[https://github.com/bruceravel/gnuplot-mode/issues/15][not terribly well supported]] on Windows
at this stage. It is possible to disable the configuration of gnuplot support
as usual by adding the package =gnuplot= to your =dotspacemacs-excluded-packages=
variable.

** Different bullets

You can tweak the bullets displayed in the org buffer in the function
=dotspacemacs/user-config= of your dotfile by setting the variable
=org-bullets-bullet-list=. By default the list is set to =("◉" "○" "✸" "✿")=.
Expand Down

0 comments on commit fa962e3

Please sign in to comment.