* Org Visibility

  :BADGE:
  [[https://www.gnu.org/software/emacs/][https://img.shields.io/badge/Emacs-27-8e44bd.svg]]
  [[http://www.gnu.org/licenses/gpl-2.0.txt][https://img.shields.io/badge/license-GPL_2-green.svg]]
  [[https://melpa.org/#/org-visibility][file:https://melpa.org/packages/org-visibility-badge.svg]]
  [[https://stable.melpa.org/#/org-visibility][file:https://stable.melpa.org/packages/org-visibility-badge.svg]]
  :END:

  Org Visibility is an Emacs package that adds the ability to persist (save and
  load) the state of the visible sections of =org-mode= files. The state is
  automatically saved when the file is saved or killed, and restored when the
  file is loaded.

  Example Configuration:

  #+BEGIN_SRC emacs-lisp
    (use-package org-visibility
      :after (org)
      :demand t
      :bind* (:map org-visibility-mode-map
                   ("C-x C-v" . org-visibility-force-save) ; defaults to `find-alternative-file'
                   ("C-x M-v" . org-visibility-remove))    ; defaults to undefined
      :custom
      ;; list of directories and files to automatically persist and restore visibility state of
      (org-visibility-include-paths `(,(file-truename "~/.emacs.d/init-emacs.org")
                                      ,(file-truename "~/org")))
      ;; list of directories and files to not persist and restore visibility state of
      (org-visibility-exclude-paths `(,(file-truename "~/org/old")
                                      ,(file-truename "~/org/test")))
      :config
      (org-visibility-mode 1))
  #+END_SRC

  Of course you will need to edit the above paths to match your setup.

  See the =Installation= and =Usage= parts of the =Commentary= section in
  [[file:org-visibility.el][org-visibility.el]] for more information and a full list of customizations.

  Emacs version 27.1 or later is required.

  Build with =make=.

  Clean with =make clean=.

  Run tests with =make test=.

  All files are generated from [[file:org-visibility.org][org-visibility.org]] using Emacs' org-mode literate
  programming system to "tangle" them.

  Copyright (C) 2021-2022 Kyle W T Sherman

  License: [[file:LICENSE][GNU General Public License 2]]