chore: update readme
This commit is contained in:
parent
dcd5c2b636
commit
e41d1fc4ea
2 changed files with 24 additions and 24 deletions
48
README.md
48
README.md
|
@ -1,36 +1,36 @@
|
||||||
# Eòlas
|
# eòlas
|
||||||
|
|
||||||
<img src='./img/knowledge_graph.png' width=400 align='center' /><br/>
|
This repository is my technical knowledge management system,
|
||||||
|
[zettelkasten](https://en.wikipedia.org/wiki/Zettelkasten) or "second-brain",
|
||||||
> Eólas is Irish for knowledge or information, especially knowledge gained by
|
comprising notes from my study of software engineering and computer science.
|
||||||
> experience or practice
|
|
||||||
|
|
||||||
This repository is my technical knowledge management system or "second-brain".
|
|
||||||
It comprises notes from my autodidactic study of software engineering and
|
|
||||||
computer science.
|
|
||||||
|
|
||||||
## Frontend
|
|
||||||
|
|
||||||
The notes can be read in a more congenial format
|
The notes can be read in a more congenial format
|
||||||
[here](https://thomasabishop.github.io/eolas). This is a
|
[online](https://thomasabishop.github.io/eolas).
|
||||||
[Neuron](https://neuron.zettel.page/) static site that I generate automatically
|
|
||||||
using a small Python
|
|
||||||
[application](https://github.com/thomasabishop/neuron-zk-generator) that
|
|
||||||
executes on each push to this repository and deploys via GitHub pages.
|
|
||||||
|
|
||||||
## Implementation
|
## Related projects
|
||||||
|
|
||||||
It is a [Zettelkasten](https://en.wikipedia.org/wiki/Zettelkasten) work in
|
### [neuron-zk-generator]()
|
||||||
progress. I've recently converted the topic-based subdirectories into a single
|
|
||||||
flat directory structure organised by tags. I'm in the process of partitioning
|
|
||||||
longer notes into smaller units.
|
|
||||||
|
|
||||||
I use the [zk](https://github.com/zk-org/zk) CLI package to help with indexing
|
Converts notes in this repository into a format that can be compiled into a
|
||||||
and task automation alongside its [zk-nvim](https://github.com/zk-org/zk-nvim)
|
[Neuron](https://neuron.zettel.page/) project and published to the Web.
|
||||||
Neovim wrapper.
|
|
||||||
|
### [eolas-db]()
|
||||||
|
|
||||||
|
A database for the entries which I use to track changes and relations between
|
||||||
|
notes. Also serves as the back-end for further transformations/utilities.
|
||||||
|
|
||||||
## Scripts
|
## Scripts
|
||||||
|
|
||||||
The [scripts](/scripts) directory contains several Bash and Python scripts I use
|
The [scripts](/scripts) directory contains several Bash and Python scripts I use
|
||||||
for general housekeeping, such as formatting image URLs, removing unused assets,
|
for general housekeeping, such as formatting image URLs, removing unused assets,
|
||||||
and autosaving.
|
and autosaving.
|
||||||
|
|
||||||
|
### `auto-commit.sh`
|
||||||
|
|
||||||
|
This is the main script for managing the project:
|
||||||
|
|
||||||
|
- standardises file names and purges unused resources
|
||||||
|
- compiles the Neuron version of the project, writing to the `/neuron`, which is
|
||||||
|
then deployed to the Web via GitHub actions and GitHub pages
|
||||||
|
- triggers the reindexing of the `eolas-db` database
|
||||||
|
- commits all changes to this repository with a timestamp
|
||||||
|
|
Binary file not shown.
Loading…
Add table
Reference in a new issue