memex/README.md

100 lines
5.0 KiB
Markdown
Raw Permalink Normal View History

[**Live web version here**](https://tangentfoxy.github.io/memex/)
2018-10-31 00:16:08 +00:00
**Memex** is a [personal knowledge base](https://scholar.colorado.edu/csci_techreports/931/).
2019-02-03 23:12:03 +00:00
A bookmarks and notes tool to help with storage and overview.
2018-07-13 15:56:09 +00:00
2019-02-03 23:12:03 +00:00
Read-only and 'sever-less' for easy sharing.
2018-07-21 11:23:06 +00:00
2019-02-03 23:12:03 +00:00
<img src='https://raw.githubusercontent.com/kormyen/memex/master/PREVIEW.jpg'/>
2018-07-21 11:23:06 +00:00
Memex supports:
2018-07-23 13:34:41 +00:00
- filtering
2018-10-30 09:20:34 +00:00
- tags
2018-07-21 11:23:06 +00:00
- images
- notes
- quotes
- terms
2018-10-30 09:20:34 +00:00
- links
- author
- files
- projects
2018-10-31 02:10:25 +00:00
- themes
2018-10-30 09:20:34 +00:00
2019-02-03 23:12:03 +00:00
To change theme simply drag a [theme svg file](https://github.com/hundredrabbits/Themes/tree/master/themes) onto the Memex webpage
2018-10-30 09:33:02 +00:00
2018-11-01 11:19:45 +00:00
More information on themes can be found [here](https://github.com/hundredrabbits/Themes)
2018-07-17 21:04:33 +00:00
2019-02-03 23:14:38 +00:00
### Examples
2018-10-31 00:16:08 +00:00
2018-10-31 02:10:25 +00:00
- [Kormyen's Memex](https://kormyen.github.io/memex/) - this repo
- [Shinestrength's Portfolio](http://www.shinestrength.xyz/) - [repo](https://github.com/shinestrength/memex)
- Dotcli's Memex - [repo](https://github.com/dotcli/memex)
2018-10-31 00:16:08 +00:00
2019-02-03 23:14:38 +00:00
### Dev
2018-10-31 02:19:19 +00:00
```
git clone git@github.com:kormyen/memex.git
```
2019-02-03 23:12:03 +00:00
Then open `memex/index.html` in any web browser
2018-10-31 02:19:19 +00:00
2018-10-31 00:12:31 +00:00
### Data
2019-02-03 23:12:03 +00:00
[memex/content/data.ndtl](content/data.ndtl)
2018-07-21 11:23:06 +00:00
2018-10-31 00:16:08 +00:00
Stored in a human-readable, flat-file database called [Indental](https://wiki.xxiivv.com/#indental) which is made by Devine Lu Linvega
2018-07-13 15:56:09 +00:00
2018-10-31 00:12:31 +00:00
### Settings
2019-02-03 23:12:03 +00:00
[memex/content/settings.js](content/settings.js)
2018-10-31 00:12:31 +00:00
2018-10-31 02:05:47 +00:00
| Setting | Description |
| ---: | :--- |
| STATSNUMTAGS | max limit of tags to show in menu |
| STATSNUMTYPE | max limit of types to show in menu |
| LOADANIMNUM | threshold number of articles in query/displayed to trigger loading animation to display |
| WIDEARTICLE | allow wide entries (`WIDE : true`) |
| AUTOWIDETRIGGER | automatically wide entry if it has more QOTE entries than this number |
2018-10-31 02:05:47 +00:00
| USEMASONRY | enable [masonry](https://masonry.desandro.com/) layout library usage |
| MASONRYPROGRESS | masonry re-layout as images load (true), or only once all images complete (false) |
| ARTICLEIDBASE | CSS name prefix |
2018-10-31 02:05:47 +00:00
| SHOWUPPER | toggle display of upper entry element(s) |
| SHOWTITLE | toggle display of entry title |
| SHOWAUTH | toggle display of entry author(s) |
| SHOWTYPE | toggle display of entry type(s) |
| SHOWLINK | toggle display of entry link(s) |
| SHOWLOWER | toggle display of lower entry element(s) |
| SHOWTAGS | toggle display of entry tag(s) |
| SHOWPROJ | toggle display of entry project(s) |
| SHOWNOTE | toggle display of entry notes |
| SHOWQOTE | toggle display of entry quote(s) |
| SHOWTERM | toggle display of entry term(s) |
| SHOWDONE | toggle display of menu done (tick/cross) |
| SHOWPROG | toggle display of entry progress notes |
| SHOWIMAG | toggle display of entry image |
| SHOWFILE | toggle display of entry file(s) |
2018-10-31 02:19:19 +00:00
| SHOWOVERLAY | toggle display of dark overlay shown when hovering image type entries to improve text readability |
2018-07-23 12:37:55 +00:00
2018-10-31 00:12:31 +00:00
### Dependencies
2018-07-13 15:56:09 +00:00
- Database parser: [Indental](https://wiki.xxiivv.com/#indental)
2018-10-30 09:20:34 +00:00
- Theming: [Themes](https://github.com/hundredrabbits/Themes)
2018-10-31 02:05:47 +00:00
- Grid layout: [Masonry](https://masonry.desandro.com/)
2018-11-01 04:46:02 +00:00
- Icons: [Font Awesome](https://fontawesome.com/)
2018-10-30 09:20:34 +00:00
2018-10-31 00:12:31 +00:00
### Thanks
2018-07-22 20:31:38 +00:00
2018-10-31 00:12:31 +00:00
- Devine Lu Linvega ([Oscean](https://github.com/XXIIVV/Oscean))
- Rekka Bell ([kokorobot](https://github.com/rekkabell/kokorobot))
- Hundred Rabbits ([Ecosystem](https://github.com/hundredrabbits))
- Josh Avanier ([Log](https://github.com/joshavanier/log))
- Alexey Botkov ([Legacy](https://github.com/nomand/Legacy))
- Seena Burns ([Isolate](https://github.com/seenaburns/isolate))
2018-07-23 12:37:55 +00:00
---
Hamish MacDonald
**[Twitter](https://twitter.com/kormyen)** &middot; **[Home](https://kor.nz)**