Index: code-docs/main.scrbl ================================================================== --- code-docs/main.scrbl +++ code-docs/main.scrbl @@ -24,47 +24,14 @@ work (due to the @ext-link["https://content-security-policy.com"]{content security policy} in effect when inside a frame). To follow such links, right-click and open the link in a new tab or window. You may also wish to @ext-link["#"]{open this page in its own tab.}} - -@section{Yarnian @italic{telos}} - -The Local Yarn is my garden: a garden of thinking and code. It’s tailored to my needs as a guy who -likes thinking, writing and publishing, isn’t an expert on anything, misses enchantment, and who -likes things to look nice. It’s a place to experiment and solve problems and be creative on several -levels at once. (You’re looking at one of the lower levels right now.) - -Whatever gets done here, the idea is to: - -@itemlist[ - @item{Invite and reward exploration; entice the visitor to go @italic{further up and further in}} - - @item{Make lush, prolific and expert use of language and typography, even obscure or gratuitous - variants, purely for their own sake} - - @item{Grow and connect new ideas, and maintain older growth} - ] - -Like a garden, @italic{The Local Yarn} has a particular layout, which is described at all levels of -detail in Design and Layout. - -@section{Yarnian @italic{cræft}} - -New areas are always being designed and added. I try to do some cyclical planning, but most of it -comes from iterative, deeply lazy, center-building iteration. - -Let’s build on the garden metaphor: this place is groomed like a garden. All the lofty notions above -— creative processes, design principles — are, in the end, underpinned by a stable of imperfect old -tools and machines. Anyone who works on the garden must learn and practice their use, understand how -to maintain them, and (eventually) when to replace them. Details of this maintenance are discussed -in Tools and Methods. - @local-table-of-contents[] @include-section["tour.scrbl"] @include-section["overview.scrbl"] @include-section["pollen.scrbl"] @; pollen.rkt @include-section["dust.scrbl"] @; dust.rkt @include-section["snippets-html.scrbl"] @; you get the idea @include-section["crystalize.scrbl"] Index: code-docs/tour.scrbl ================================================================== --- code-docs/tour.scrbl +++ code-docs/tour.scrbl @@ -3,18 +3,18 @@ @; SPDX-License-Identifier: BlueOak-1.0.0 @; This file is licensed under the Blue Oak Model License 1.0.0. @(require "scribble-helpers.rkt") -@(require (for-label racket/base "../pollen.rkt")) +@(require (for-label racket/base pollen/core "../pollen.rkt")) -@section{How I Publish: A Quick Tour} +@title{How I Publish: A Quick Tour} This isn’t a tutorial, since these steps probably won’t all work on your computer. Think of these narrations like me talking while I drive. -@subsection{Creating an article} +@section{Creating an article} Open a terminal window. @terminal{@cmd{> cd /path/to/thelocalyarn}} @@ -92,11 +92,11 @@ As you can see, Fossil does an automatic pull before the commit, and another automatic push afterwards. This commit is now visible on the public timeline, and the source code for the article can now be seen on the public repo at @tt{thelocalyarn.com/code/}. -@subsection{Adding notes to an article} +@section{Adding notes to an article} A few days (or years) after doing the above, I receive an email from Marjorie with commenting on @italic{My New Post} and I decide to publish her comments. I open the article in my editor and add some lines to the end: @@ -127,10 +127,10 @@ But if you go to the Blog section, you’ll see the note appearing in its own space right alongside the other articles, as if it were a separate post. It will also appear in a separate entry in the RSS feed. -@subsection{What’s not here yet} +@section{What’s not here yet} Eventually there will be facilities for creating PDF files of individual articles, and print-ready PDFs of books containing collections of articles.