mirror of
https://github.com/schollz/cowyo.git
synced 2023-08-10 21:13:00 +03:00
102 lines
2.8 KiB
Markdown
102 lines
2.8 KiB
Markdown
|
|
<p align="center">
|
|
<img
|
|
src="/static/img/logo.png"
|
|
width="260" height="80" border="0" alt="linkcrawler">
|
|
<br>
|
|
<a href="https://travis-ci.org/schollz/cowyo"><img src="https://img.shields.io/travis/schollz/cowyo.svg?style=flat-square" alt="Build Status"></a>
|
|
<a href="https://github.com/schollz/cowyo/releases/latest"><img src="https://img.shields.io/badge/version-2.3.0-brightgreen.svg?style=flat-square" alt="Version"></a>
|
|
</p>
|
|
|
|
<p align="center">A feature-rich wiki for minimalists</a></p>
|
|
|
|
*cowyo* is a self-contained wiki server that makes jotting notes easy and _fast_. The most important feature here is _simplicity_. Other features include versioning, page locking, self-destructing messages, encryption, and listifying. You can [download *cowyo* as a single executable](https://github.com/schollz/cowyo/releases/latest) or install it with Go. Try it out at https://cowyo.com.
|
|
|
|
Getting Started
|
|
===============
|
|
|
|
## Install
|
|
|
|
If you have go
|
|
|
|
```
|
|
go get -u github.com/schollz/cowyo/...
|
|
```
|
|
|
|
or just [download the latest release](https://github.com/schollz/cowyo/releases/latest).
|
|
|
|
## Run
|
|
|
|
To run just double click or from the command line:
|
|
|
|
```
|
|
cowyo
|
|
```
|
|
|
|
and it will start a server listening on `0.0.0.0:8050`. To view it, just go to http://localhost:8050 (the server prints out the local IP for your info if you want to do LAN networking). You can change the port with `-port X`, and you can listen *only* on localhost using `-host localhost`.
|
|
|
|
### Running with TLS
|
|
|
|
Specify a matching pair of SSL Certificate and Key to run cowyo using https. *cowyo* will now run in a secure session.
|
|
|
|
*N.B. Let's Encrypt is a CA that signs free and signed certificates.*
|
|
|
|
```
|
|
cowyo --cert "/path/to/server.crt" --key "/p/t/server.key"
|
|
```
|
|
|
|
## Usage
|
|
|
|
*cowyo* is straightforward to use. Here are some of the basic features:
|
|
|
|
### Editing
|
|
|
|
When you open a document you'll be directed to an alliterative animal (which is supposed to be easy to remember). You can write in Markdown. Saving is performed as soon as you stop writing. You can easily link pages using [[PageName]] as you edit.
|
|
|
|
|
|
|
|
### History
|
|
|
|
You can easily see previous versions of your documents.
|
|
|
|
|
|
|
|
### Lists
|
|
|
|
You can easily make lists and check them off.
|
|
|
|
|
|
|
|
### Locking
|
|
|
|
Locking prevents other users from editing your pages without a passphrase.
|
|
|
|
|
|
|
|
### Encryption
|
|
|
|
Encryption is performed using AES-256.
|
|
|
|
|
|
|
|
### Self-destructing pages
|
|
|
|
Just like in mission impossible.
|
|
|
|
|
|
|
|
## Development
|
|
|
|
You can run the tests using
|
|
|
|
```
|
|
$ cd $GOPATH/src/github.com/schollz/cowyo
|
|
$ go test ./...
|
|
```
|
|
|
|
Any contributions are welcome.
|
|
|
|
## License
|
|
|
|
MIT
|