A tiny tool to present and manage your reading and notes.
Project description
Paperead
Paperead A tiny tool to present and manage your reading and notes.
- Platform
- Python
Install
Use pip:
pip install paperead
Or use pipx:
# Install pipx
pip install --user pipx
pipx ensurepath
# Install Schemdule
pipx install paperead
# Upgrade
pipx upgrade paperead
Usage
Command-line Management
Create/Delete/List materials and notes.
# Use current directory as data directory
paperead new/rm/list --help
# Custom data directory
paperead -D "path/to/dataDir" <COMMANDS>
Serve Website
paperead serve
paperead -D "path/to/dataDir" serve
Then visit http://localhost:3649
.
Data Directory
Paperead works in a data directory. The directory's structure is like the following.
/
material1/
description.md
assets/
notes/
note1.md
Material Description
<material>/description.md
contains the metadata and the description for the material.
---
# Metadata in YAML
name: Name
creation: 2021-09-26 09:00:00+00:00
modification: 2021-09-26 09:00:00+00:00
targets:
image: "./assets/image.png"
tags:
- tag1
- tag2
extra:
key1: "value1"
key2: "value2"
---
Description in Markdown.
Notes
<material>/notes/<note>.md
contains the metadata and the content for the note for the material.
---
# Metadata in YAML
name: Name
creation: 2021-09-26 09:00:00+00:00
modification: 2021-09-26 09:00:00+00:00
---
Content in Markdown.
Assets
<material>/assets/
contains all additional files for the material, this will be directly served as static files,
and all .md
files for the material can access these files by using ./assets/...
or ../assets/...
(just relative path).
Development
# Run backend
cd src/main
python -m paperead -D "path/to/dataDir" serve
# endpoint: http://localhost:3649/api
# Run frontend
cd src/web
npm run dev
# endpoint: http://localhost:3000
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.