There are two ways to configure beorg:
- On the Settings tab
- By creating an
init.orgfile
For most users the Settings tab contains everything they need to setup beorg. If you need to do some more advanced customisation you’ll need an init.org file.
The format of the init.org file
The init.org file is a normal beorg file that contains some blocks of Scheme code. Here is an example:
* Fonts
#+begin_src scheme
(set! editor-font "Menlo 15")
(set! repl-font "Menlo 15")
#+end_src
* Todo states
#+begin_src scheme
(set! org-todo-action-keywords '("TODO" "NEXT" "IN-PROGRESS" "WAITING"))
#+end_src
The Scheme code is inside a special block which starts with #+begin_src scheme and ends #+end_src. Everything else is ignored, but is useful to help you structure the file.
Creating an init.org file
On the Files tab tap the + at the top left of the screen and enter the file name init. Note that you don’t need to add the .org extension - this gets added for you.
Editing the init.org file
I prefer to edit my init.org file using the text editor. Hold down your finger on the init file on the Files tab and select Open With Text Editor….
As you’ll be mostly typing Scheme code you are best telling the editor to disable autocorrect.
What next?
There are a number of resources on the beorg website to help you learn more about what you can customise using the init.org:
- How To Articles - check out the Master section.
- An Introduction to beorg Scripting
