First reply:
{M-: hyperbole-version RET}
-- Bob
> On Jun 16, 2025, at 2:44 PM, Cena Mayo <cenaz...@gmail.com> wrote:
>
>
> Hi y'all,
>
> I sort of gave up on Koutliner as mode for a bit; I struggled with some basic
> stuff, like the dreaded top margin, but the overall issue for me was that I
> just didn't have an immediate use case for an auto-numbered outline.
>
> Well, I started going through the Intro to Emacs Lisp book, taking notes in
> org, adding headlines for each chapter; eg:
>
> * Preface
> * 1 - List Processing
> ** 1.1 Lisp Lists
> *** examples
> ** 1.2 Lisp Atoms
> ...
>
> I belatedly realized: hey, I could use Koutliner for this!
>
> So I went back through the documentation and ran across the command that
> converts existing org files to .kotl, nice!
>
> Then the questions set in. Here they are:
>
> 1 - there doesn't seem to be a way to create a 'title' for the file, in the
> file. More specifically, my org #+TITLE was inserted into cell 1, but that
> then throws off the outline numbering. Can Koutliner files have a title
>
> Is cell 0 usable for this purpose, or is it only for establishing the root of
> the outline to follow?
>
> Because I'm a total wiz at chapter 1 of EINTR, I poked around the Koutliner
> code in an attempt to discover an answer.
>
> Is something like this possible?
>
>> (defun my-kotl-title (title)
>> (interactive "Title: ")
>> (call-interactively title))
> (defun kcell:set-title (kcell)
> "Store the current file's title as the title of KCELL."
> (kcell:set-attr kcell 'title my-kotl-title)))
>
> (defvar my/kcell:read-only-attributes
> '(idstamp title creator create-time modifier mod-time)
> "List of kcell attributes which may not be modified by a user.
> Add to this list but don't remove any of the default elements.")
>
> ---
>
> 2 - Koutliner correctly imported my org markup, eg: /emph/ *bold*, etc. The
> manual doesn't seem to mention markup. What markup does Koutliner understand
> out of the box?
>
> ---
>
> 3 - Due to #1, above, the imported outline displays like so:
>
>> 1. #+TITLE An Introduction to Programming in Emacs Lisp
>> #+DATE <2025-06-16 Mon>
> ... (notes on Preface)
> 3. 1 - List Processing
>
> 3.1. 1.1 Lisp Lists
>
> 3.1.1. example: '(rose violet daisy buttercup) is a list
>
> 3.1.2. example: *(+ 2 2) is a list*
>
> 3.1.3. example: /'(this list has (a list inside of it))/
>
> 3.2. 1.1.1 Lisp Atoms
> ---
>
> Okay - it doesn't understand the hierarchy I was attempting to create in org,
> that's understandable.
>
> However, even with a starting from scratch .kotl, it seems I can't have an
> outline that follows the chapter/subchapter headings (1, 1.1, etc) due to the
> hard-wired "starting from 1" outline.
>
> That means: I cannot take notes on the Preface, qua Preface; even without a
> 'title', it would be assigned to cell 1, and chapter 1 will be 2., 1.1 =>
> 2.1, etc.
>
> The only (apparent) resolution is to start with chapter 1.
>
> Is there any workaround, or is that just how it is? (It seems I may need to
> progress to EINTR chapter 2, at least, before I might attempt to ferret out
> an answer on my own.)
>
> ---
> Hyperbole version: 9.0.2pre, updated today
>
> Side question: is there a way to get the current version, ala M-x
> org-version? For a repo install, that command returns something like :
> Org mode version 9.8-pre (release_9.7.30-367-ge8413b")
> ---
>
>
> As always, I appreciate your time, and hope y'all're having a good summer so
> far.
>
> Best,
> C. Mayo
>
