Help:Bop entries - Revision history

Reversedragon: there is a CSS file by now

2025-06-13T15:25:13Z

there is a CSS file by now

← Older revision		Revision as of 15:25, 13 June 2025
Line 27:		Line 27:
	* [[Template:BopRev\|rev]] (<code aria-label=""><nowiki>>></nowiki></code>) - link semantically implying resource is a later revision or rewrite		* [[Template:BopRev\|rev]] (<code aria-label=""><nowiki>>></nowiki></code>) - link semantically implying resource is a later revision or rewrite
	* [[Template:BopVer\|ver]] (<code aria-label=""><nowiki><<</nowiki></code>) - link semantically implying resource is an earlier note, scrap, or revision which was used to create the current entry		* [[Template:BopVer\|ver]] (<code aria-label=""><nowiki><<</nowiki></code>) - link semantically implying resource is an earlier note, scrap, or revision which was used to create the current entry
	** (This line has been perpetually in "todo" status in previous bop parsers, such that it is often rendered "<~~nowiki~~>; <<</~~nowiki~~>")		** (This line has been perpetually in "todo" status in previous bop parsers, such that it is often rendered "<code>; <<</code>")
	* ~~CSS~~ - ~~ideally there would be a single~~ stylesheet for all bop entries~~, but as~~ this wiki ~~currently does not have stylesheet support, this is currently being done by pasting explicit styles into every entry.~~		* [[Template:BopCSS1]] - stylesheet for all bop entries currently on this wiki


	[[Category:Bop format]] [[Category:MDem entries]]		[[Category:Bop format]] [[Category:MDem entries]]

Reversedragon: category

2025-03-06T11:40:12Z

Reversedragon: category

2025-01-23T01:13:53Z

Reversedragon: Reversedragon moved page Philosophical Research:Bop entries to Help:Bop entries: technical explanation page

2025-01-23T01:13:08Z

Reversedragon moved page Philosophical Research:Bop entries to Help:Bop entries: technical explanation page

← Older revision	Revision as of 01:13, 23 January 2025
(No difference)

Reversedragon: BopAlias

2025-01-05T07:53:49Z

BopAlias

← Older revision		Revision as of 07:53, 5 January 2025
Line 19:		Line 19:
	== bop templates ==		== bop templates ==

			* [[Template:BopAlias]] - show title of bop entry
			** [[Template:BopAliasE]] - show title of bop entry escaped for filename/URL
	* [[Template:BopFooter]] - common set of title and date lines seen in many bop files		* [[Template:BopFooter]] - common set of title and date lines seen in many bop files
	** [[Template:BopFooter/time]] - to be used for rendering times a bit more legibly once parser functions are installed		** [[Template:BopFooter/time]] - to be used for rendering times a bit more legibly once parser functions are installed

Reversedragon: sub-templates

2025-01-05T07:44:59Z

sub-templates

← Older revision		Revision as of 07:44, 5 January 2025
Line 20:		Line 20:

	* [[Template:BopFooter]] - common set of title and date lines seen in many bop files		* [[Template:BopFooter]] - common set of title and date lines seen in many bop files
			** [[Template:BopFooter/time]] - to be used for rendering times a bit more legibly once parser functions are installed
			** [[Template:BopFooter/style]] - to be used for styling bop entries when page CSS is installed
	* [[Template:BopFwd\|fwd]] (<code aria-label=""><nowiki>=></nowiki></code>) - generic "sideways" link used to link to any other entry		* [[Template:BopFwd\|fwd]] (<code aria-label=""><nowiki>=></nowiki></code>) - generic "sideways" link used to link to any other entry
	* [[Template:BopRev\|rev]] (<code aria-label=""><nowiki>>></nowiki></code>) - link semantically implying resource is a later revision or rewrite		* [[Template:BopRev\|rev]] (<code aria-label=""><nowiki>>></nowiki></code>) - link semantically implying resource is a later revision or rewrite

Reversedragon: Created page with "bop is an extreme-minimalist content management system, similar to the concept of a [https://en.wikipedia.org/wiki/Zettelkasten card box]. It consists of a particular file format, most typically in the form of text files structured according to bop syntax, and optionally, a program which can parse this syntax. With the exception of bop-related MediaWiki templates, all programs for parsing bop files are currently unmaintained, but it is possible this will ch..."

2025-01-03T22:11:22Z

Created page with "bop is an extreme-minimalist content management system, similar to the concept of a [https://en.wikipedia.org/wiki/Zettelkasten card box]. It consists of a particular file format, most typically in the form of text files structured according to bop syntax, and optionally, a program which can parse this syntax. With the exception of bop-related MediaWiki templates, all programs for parsing bop files are currently unmaintained, but it is possible this will ch..."

New page

bop is an extreme-minimalist content management system, similar to the concept of a [https://en.wikipedia.org/wiki/Zettelkasten card box]. It consists of a particular file format, most typically in the form of text files structured according to bop syntax, and optionally, a program which can parse this syntax. With the exception of bop-related MediaWiki templates, all programs for parsing bop files are currently unmaintained, but it is possible this will change in the future.

The name bop derives from the [https://en.wikipedia.org/wiki/BOP_clade BOP clade] of grasses, containing families Bambusa, Oryza, and Poa. In the [https://codeberg.org/vxsh-suite/bop-recode bop-recode] project (the most recent bop-parsing program), these three groups of grasses serve as names for the Lisp module's three main components.

== bop syntax ==

bop files are designed with a similar but not identical ethos to [https://hexdocs.pm/gemtext/Gemtext.html gemini webpages]. Each text file contains a line-oriented footer below an arbitrary body, such that the parser can assume that either two empty lines or a series of hard-rule characters separate the body from the metadata section. Whether the body of the file will be parsed is a matter for the parser to decide. Each line in the metadata section is always parsed into a metadata statement, but a parser may decide to treat the body purely as a preformatted text file.

=== Programmability ===

bop's initial concept allows for both metadata types and body formatting syntax to be programmable through either additional Lisp modules supplied to extend the format or through user-supplied data structures. In practice, no existing parser has successfully implemented this feature, leading most bop files and parsers currently in existence to focus on a core prescriptive set of metadata lines and body formatting patterns which are obeyed with relative consistency yet never officially standardized. On occasion, some bop files may contain experimental body patterns or experimental metadata lines, although for the benefit of real-world parsers it is typical to leave said metadata lines commented out.

in bop's initial concept, arbitrary body formatting patterns were to be defined using particular types of metadata lines, which would link these patterns to some particular pre-defined visual presentation in order for each to be parsed and rendered into any supported format such as RTF, HTML, or TeX. In theory, this means the precise details of any particular bop file's syntax can be almost entirely up to the entry author; an entry could opt to use rules identical to Markdown, identical to HTML tags, or purely according to the author's own arbitrary formatting scheme. In practice, most bop files in existence are likely to use a formatting syntax loosely similar to Markdown but with its linking ability replaced with footnotes pointing to links in the metadata section.

As far as displaying bop files in MediaWiki, the notion of programmability can be partially simulated with specific wiki templates each used to define the appearance of a metadata line — here the "programming" or "extension" occurs inside each new template.

The prospect of programming body formatting is more difficult, although possible. MediaWiki supports parser functions, enabling a particular block of bop text with a particular known set of formatting to be parsed through a limited parser implemented inside MediaWiki.

== bop templates ==

* [[Template:BopFooter]] - common set of title and date lines seen in many bop files
* [[Template:BopFwd|fwd]] (<code aria-label=""><nowiki>=></nowiki></code>) - generic "sideways" link used to link to any other entry
* [[Template:BopRev|rev]] (<code aria-label=""><nowiki>>></nowiki></code>) - link semantically implying resource is a later revision or rewrite
* [[Template:BopVer|ver]] (<code aria-label=""><nowiki><<</nowiki></code>) - link semantically implying resource is an earlier note, scrap, or revision which was used to create the current entry
** (This line has been perpetually in "todo" status in previous bop parsers, such that it is often rendered "<nowiki>; <<</nowiki>")
* CSS - ideally there would be a single stylesheet for all bop entries, but as this wiki currently does not have stylesheet support, this is currently being done by pasting explicit styles into every entry.

← Older revision		Revision as of 11:40, 6 March 2025
Line 30:		Line 30:
	* CSS - ideally there would be a single stylesheet for all bop entries, but as this wiki currently does not have stylesheet support, this is currently being done by pasting explicit styles into every entry.		* CSS - ideally there would be a single stylesheet for all bop entries, but as this wiki currently does not have stylesheet support, this is currently being done by pasting explicit styles into every entry.

	[[Category:MDem entries]]		[[Category:Bop format]] [[Category:MDem entries]]

← Older revision		Revision as of 01:13, 23 January 2025
Line 29:		Line 29:
	** (This line has been perpetually in "todo" status in previous bop parsers, such that it is often rendered "<nowiki>; <<</nowiki>")		** (This line has been perpetually in "todo" status in previous bop parsers, such that it is often rendered "<nowiki>; <<</nowiki>")
	* CSS - ideally there would be a single stylesheet for all bop entries, but as this wiki currently does not have stylesheet support, this is currently being done by pasting explicit styles into every entry.		* CSS - ideally there would be a single stylesheet for all bop entries, but as this wiki currently does not have stylesheet support, this is currently being done by pasting explicit styles into every entry.

			[[Category:MDem entries]]