akkartik/techmeet.love - Change AJXODNV54URZXX5NMU4NPB3NDNOAX7SPSQGS34OMZRAHHXRZ6CFQC

new fork: collaborative wiki for Lion Kimbro's community

Created by Kartik K. Agaram on September 10, 2022

AJXODNV54URZXX5NMU4NPB3NDNOAX7SPSQGS34OMZRAHHXRZ6CFQC

Dependencies

In channels

main

Change contents

Replacement in source.lua at line 77 [7.165766]

B:BD[7.167316] → [8.3412:3461]

  love.window.setTitle('pensieve.love - source')

[7.167316]

  love.window.setTitle('techmeet.love - source')

Replacement in source.lua at line 205 [7.165766]

B:BD[7.172371] → [8.3462:3511]

  love.window.setTitle('pensieve.love - source')

[7.172371]

  love.window.setTitle('techmeet.love - source')

Replacement in run.lua at line 138 [7.178044]
B:BD[7.178636] → [8.8401:8441]
```
  love.window.setTitle('pensieve.love')
```
[7.178636]
[8.8441]
```
  love.window.setTitle('techmeet.love')
```

Replacement in commands.lua at line 535 [9.39]

B:BD[4.122] → [4.122:197]

-- columns are always filenames. pensieve.love won't ever create filenames

[4.122]

[4.197]

-- columns are always filenames. techmeet.love won't ever create filenames

Replacement in README.md at line 1 [10.6]

B:BD[10.6] → [11.51:199]

B:BD[11.199] → [12.51:244]

In progress. Manage a directory tree containing plain-text notes (with [some
line drawings](http://akkartik.name/lines.html)). Notes/files can have
[cross-links](https://merveilles.town/@akkartik/108766067153506592) (not
hyperlinks, but that's planned) with other notes, which are saved outside the
plain-text in a corresponding .json file.

[10.6]

[13.51]

In progress. Beginnings of a possible shared wiki and discussion system for
[Lion Kimbro's Internet Office Hours](https://communitywiki.org/wiki/LionKimbro)
community.

Replacement in README.md at line 5 [10.6]

B:BD[13.52] → [13.52:320]

pensieve.love is a compatible fork of [lines.love](http://akkartik.name/lines.html),
an editor for plain text where you can also seamlessly insert line drawings.
Designed above all to be easy to modify and give you early warning if your
modifications break something.

[13.52]

[14.18]

Techmeet.love started out as [a private single-person note-taking
system](https://git.sr.ht/~akkartik/pensieve.love). It is now a space for the
long-form asynchronous communications of a small community, and a place to
experiment with and evolve new ideas for such collaborative communications.
Some features:
- Multiple views into an independent repo of plain text notes (with [some line
  drawings](http://akkartik.name/lines.html)).
- Notes can have arbitrary named relationships (links) to each other,
  resulting in a graph.
- The primary visual metaphor is an infinite 2D surface of fixed-width,
  non-overlapping, notes that can be operated on with an extensible set of
  commands.
- Commands usually (but not always) create new columns of notes. Each column
  is an independent visualization of a subset of notes.
- App sources can be seamlessly edited from within the app (though packaging
  up modifications to share with others currently has some seams; see below)
- Notes can contain hyperlinks in [[wikiwords]] to other notes. Hyperlinks
  can't contain spaces. Clicking on a hyperlink opens the target in a new
  column.
- A few other things. Explore the command menu and palette along the top.

Replacement in README.md at line 29 [10.6]

B:BD[14.163] → [15.68:112]

LÖVE. Get it from https://love2d.org (5MB)

[16.21]

[5.54]

LÖVE. Get it from https://love2d.org (5MB), following the instructions for
your OS. There should be no other dependencies to install.

Replacement in README.md at line 32 [10.6]
B:BD[17.223] → [15.113:159]
```
## Invocation, and where your notes will live
```
[17.223]
[18.99384]
```
## Getting started
```

Replacement in README.md at line 34 [10.6]

B:BD[17.379] → [18.99400:99512]

To try out pensieve.love with some sample data, run the following command from
this repo's top-level directory:

[18.99385]

[18.99512]

There's currently a few moving parts to set up:

Replacement in README.md at line 36 [10.6]

B:BD[18.99513] → [18.99513:99535]

```
love . sample
```

[18.99513]

[18.99535]

0. Clone this repo.
  ```
  git clone https://git.sr.ht/~akkartik/techmeet.love techmeet
  ```

Replacement in README.md at line 41 [10.6]

B:BD[18.99536] → [15.160:279]

This will read the notes from the `data.sample/` directory in this repo to
give you a flavor for what the app is like.

[18.99536]

[15.279]

1. Determine where to store data for the app. This location is OS-dependent
   and constrained by LÖVE's restrictions on apps for privacy reasons. Run the
   following command from a terminal:
   ```
   love techmeet
   ```
   On my computer I see this message in the terminal window:
   ```
   reading notes from /home/akkartik/.local/share/love/techmeet/data/
   put any notes there (and make frequent backups)
   ```

Replacement in README.md at line 55 [10.6]

B:BD[15.280] → [15.280:355]

B:BD[15.355] → [2.51:369]

∅:D[19.194] → [20.271:419]

∅:D[21.196] → [20.271:419]

∅:D[2.369] → [20.271:419]

B:BD[20.271] → [20.271:419]

B:BD[20.419] → [3.51:165]

While the sample gives you stuff to browse, don't use it to write any real
notes. LÖVE limits what directories apps can list files from (which is great
for privacy), but has some confusing rules around them. Each app can only
write to files under a single directory, the app's _save directory_
([love.filesystem.getSaveDirectory()](https://love2d.org/wiki/love.filesystem.getSaveDirectory)).
In addition, reads will also fall back to read from the repo directory,
enabling the sample experience. However, edits you make will not modify the
`data.sample/` directory in this repo. Your notes will fragment between two
directories, which can get confusing.

[15.280]

[18.99666]

2. Install the shared repo of notes in the directory mentioned above. For me
   that command is:
   ```
   git clone https://git.sr.ht/~akkartik/techmeet-data.love /home/akkartik/.local/share/love/techmeet/data/
   ```
   Adjust the final path for yourself.

Replacement in README.md at line 64 [10.6]
B:BD[18.99667] → [15.704:768]
```
To create your own directory of notes, run without an argument:
```
[18.99667]
[18.99667]
```
3. Run the app again:
```
Replacement in README.md at line 66 [10.6]
B:BD[18.99668] → [15.769:784]
```
```
love .
```
```
[18.99668]
[18.100063]
```
   ```
   love techmeet
   ```
```

Replacement in README.md at line 70 [10.6]

B:BD[18.100064] → [15.785:864]

B:BD[15.864] → [20.521:588]

pensieve.love will then create a `data/` directory in the app's save directory
as above. Confusing location, but everything will be in one place.

[18.100064]

[8.64061]

   Your OS will likely have ways to run this command based on a global
   shortcut, should you so desire.

Replacement in README.md at line 75 [10.6]

B:BD[8.64084] → [6.64:358]

Hit `ctrl+w` from within the app to modify its code. The infrastructure works,
but it isn't advertised within the app because this particular app is
currently too large to comfortably modify from within itself. I use more
specialized editors while I improve the editing infrastructure further.

[8.64084]

[22.18]

Hit `ctrl+w` from within the app to modify its code. I've only used it to edit
simpler forks so far, but would love to collaborate on improving it.

Replacement in README.md at line 131 [10.6]
B:BD[13.452] → [13.452:496]
```
* https://git.sr.ht/~akkartik/pensieve.love
```
[13.452]
[13.496]
```
* https://git.sr.ht/~akkartik/techmeet.love
```

Replacement in README.md at line 137 [10.6]

B:BD[13.597] → [13.597:716]

* https://git.sr.ht/~akkartik/capture.love provides a blank-slate UI into the
  same notes directory as pensieve.love.

[13.597]

[13.716]

* https://git.sr.ht/~akkartik/techmeet-capture.love provides a blank-slate UI
  into the same notes directory as techmeet.love.

Replacement in README.md at line 146 [10.6]

B:BD[23.52] → [23.52:126]

In particular, pensieve.love has been exclusively tested so far with a US

[23.52]

[23.126]

In particular, techmeet.love has been exclusively tested so far with a US