Metadata-Version: 2.1
Name: wirikiki
Version: 1.1.2
Summary: A tiny desktop wiki
Home-page: http://github.com/fdev31/wirikiki/
Author: fdev31
Author-email: fdev31@gmail.com
Requires-Python: >=3.10,<4.0
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Requires-Dist: aiofiles (>=0.8.0,<0.9.0)
Requires-Dist: fastapi (>=0.79.0,<0.80.0)
Requires-Dist: orjson (>=3.7.11,<4.0.0)
Requires-Dist: python-jose (>=3.3.0,<4.0.0)
Requires-Dist: python-multipart (>=0.0.5,<0.0.6)
Requires-Dist: setproctitle (>=1.3.0,<2.0.0)
Requires-Dist: tomli (>=2.0.1,<3.0.0)
Requires-Dist: uvicorn (>=0.18.2,<0.19.0)
Description-Content-Type: text/markdown

_Wirikiki_ aims at being a productivity oriented **markdown notebook**.
It's compatible with the most common features supported by GitHub's markdown and adds a few other.

Aims at

- fast / **small** footprint
- **simplicity** of use
- **uncluttered** UI supporting both **dark & bright modes**
- **advanced markdown support** via [markItDown](https://markitdown.netlify.app/) and plugins and [Marked](https://marked.js.org/) for the editor
- auto **archival** (using git)

# Installation

## Building

3 ways to get a runnable code:

- install a release (eg: using `pip`)
- `make dev`
- manual installation

```
sh ./makevueApps.sh
npm install
DIST=1 ./node_modules/.bin/rollup -c rollup.config.js
```

# Usage

## Create one wiki

```
wirikiki new myNewWiki
```

## Run the wiki

Go to the newly created folder "myNewWiki" and run:

```
wirikiki
```

## Zero-install mode

You can just open the html file to get a degraded experience, data will not be saved.

## Keyboard shortcuts

| Key            | Description                                     |
| -------------- | ----------------------------------------------- |
| **Escape**     | Close editor or modal, else toggles the sidebar |
| **Del**        | **D**elete current page                         |
| **E**          | **E**dit current note                           |
| **F**          | Search/**F**ind something                       |
| **N**          | **C**reate a new note                           |
| **Left/Right** | Switch to previous/next note                    |

# Advanced usage

Basic git support is provided, to enable it just type `git init` in the `myKB` folder.

```shell
cd myKB
git init
```

# Dependencies

- **Python 3**
  - if you want to run it **without the virtualenv** you will need the following python packages:
    - aiofiles
    - fastapi
    - uvicorn
- nodejs and npm (BUILD ONLY)
- inotify-tools (DEV ONLY)

# Developers note

This is built using
[Vue.js version 3](https://v3.vuejs.org/) for the front
and [FastAPI](https://fastapi.tiangolo.com/) for the server side.

