experimental 'microwiki implementation' / 'mini CMS'
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
Takumi 733fab4dc0 turn main.lisp into asdf system 16 hours ago
bash-tools create gamebook format "twinned"; per-publish-target configuration 1 day ago
core turn main.lisp into asdf system 16 hours ago
core-cli turn main.lisp into asdf system 16 hours ago
core-ext-bluebird implement "afraid bluebird" in render-html 10 months ago
core-ext-emacs begin emacs mode, add setting for editor 4 months ago
core-ext-shortcuts separate render formats, clean AP revisions 12 months ago
installer mostly finish debian installer 1 year ago
issues.bop create gamebook format "twinned"; per-publish-target configuration 1 day ago
render create gamebook format "twinned"; per-publish-target configuration 1 day ago
render-ext-ap create gamebook format "twinned"; per-publish-target configuration 1 day ago
render-ext-atom begin emacs mode, add setting for editor 4 months ago
render-ext-pubgroup publish only desired pages using tags 1 year ago
render-ext-twinned create gamebook format "twinned"; per-publish-target configuration 1 day ago
render-ext-ytp export stylesheet with ytp-neo 10 months ago
render-gmi display date on root node 12 months ago
render-html create gamebook format "twinned"; per-publish-target configuration 1 day ago
rules create gamebook format "twinned"; per-publish-target configuration 1 day ago
tests create gamebook format "twinned"; per-publish-target configuration 1 day ago
.gitignore create simple Makefile installer 1 year ago
COPYING manually excerpt entries, publish single directory 1 year ago
LICENSE add README & LICENSE 2 years ago
Makefile create simple Makefile installer 1 year ago
README.md add publish targets 1 year ago
bop turn main.lisp into asdf system 16 hours ago

README.md

bopwiki (/'bop') is meant to be a simple "microwiki" implementation ─ a wiki-like system designed for recording very small thoughts and contextual connections between things.

the idea is to make something useful for concise summaries of complex knowledge, very simple issue trackers, a way to organise your mastodon threads, a place to draft ideas for longer webpages without publicly microblogging, etc.
(a teeny bit like tiddlywiki, but much more friendly to opening raw pages in a separate text editor and not necessarily needing both an entire backend engine + browser to view.)

it's fairly similar to a Zettelkasten system.

(for more on "microwikis", see the original mastodon thread:)
unrolled / original


"Documentation"

code files

bop has just been ported to a proper asdf system structure. This new code structure will be internally documented some time soon as it goes through the process of being fully cleaned up.

working features

(possibly incomplete list)

  • microwiki pages - simple text files named as their created time with optional metadata lines at bottom
    • open a new page in external editor - bop new
    • manually nickname a page outside of bop, e.g. "1602312899_test.txt"
    • list all pages visible from current directory - bop list
  • renaming pages
    • changing page nickname - bop rename test newname renames 1602312899_test.txt to 1602312899_newname.txt
    • changing page date - bop rename test 1412952899 renames 1602312899_test.txt to 1412952899_test.txt
  • edit pages by either their ID or nickname - bop open test opens 1602312899_test.txt
  • features for journalling
    • mark a page as today, or open it - bop today pagename, bop today
  • render page + replies to simple webpage - bop publish
    • publish specific defined groups of directories to a format, or to multiple formats in sequence (extension)
    • render pages to atom feed (experimental)

in-progress / planned features

Currently in-progress tasks are in the TODO file, and longer-term tasks are in the "issue tracker" folder, issues.bop.
You can use bop publish in that directory and open file:///tmp/issues-bop/index.htm to see an overview.

(An end-user documentation thread is also under construction inside issues.bop, though far from finished - see "0947217626_docs.htm" in the issues-bop folder.)

branches & updates

bop technically has two branches - my private branch unstable, and the public branch main.
This is mainly so I can endlessly amend commits on unstable until I lock them in, 'release' them to my public forge page, and start the next update.
so, if the README you see here looks suspiciously outdated, it's somewhat likely I'm sitting on an unfinished update that will release later, and you only need to be patient. (or bug me with questions)

bop is now almost able to install all its dependencies using the installer directory.
This is not quite ready, but when it is, you will be able to install a "development" version of bop on either manjaro/arch or debian using make && make install.

PKGBUILDs for building bop-related arch/debian packages live at codeberg.org/...bop-ytp-pkgbuild.
There may also eventually be a regularly-updated place to get binary "non-development" packages (like a PPA), but my system for putting one up on a git host is still too experimental right now.

License

bop is released under the GPL3 in anticipation of it either integrating with or replacing spectrom.