Add documentation
This commit is contained in:
parent
933affe6b4
commit
e69a00f446
|
@ -0,0 +1,15 @@
|
||||||
|
Pixwhile is an alternative frontend to Pixiv that utilizes no Javascript.
|
||||||
|
|
||||||
|
## Features
|
||||||
|
|
||||||
|
- Does not contain an asinine amount of Javascript
|
||||||
|
- Allows you to open the original versions of cover images and profile pictures
|
||||||
|
- Can view illustrations and list user illustrations
|
||||||
|
|
||||||
|
## Missing Features
|
||||||
|
|
||||||
|
This list is not exhaustive, nor does it mean that these are being worked on.
|
||||||
|
|
||||||
|
- No search
|
||||||
|
- No ability to login
|
||||||
|
- No ability to see comments or like counts
|
|
@ -0,0 +1,27 @@
|
||||||
|
## Compiling
|
||||||
|
|
||||||
|
- `mkdir build`
|
||||||
|
- `cd build`
|
||||||
|
- Execute one of the following commands depending on your conditions:
|
||||||
|
- If this is going to be on production (aka is not for debugging),
|
||||||
|
run `cmake -B . .. -DCMAKE_BUILD_TYPE=Release`
|
||||||
|
- If you are debugging Pixwhile, run `cmake -B . .. -DCMAKE_BUILD_TYPE=Debug`
|
||||||
|
- `make -j$(nproc)`
|
||||||
|
|
||||||
|
## Configuration
|
||||||
|
|
||||||
|
Copy `example_config.json` to a file with any name you like
|
||||||
|
(e.g. `config.json`), then open the copied file and edit the parameters to your
|
||||||
|
liking (they should be self-explanatory, especially with comments).
|
||||||
|
|
||||||
|
Pixwhile is intended to be run behind a reverse proxy (e.g. Nginx), so you
|
||||||
|
should set your reverse proxy to proxy requests to
|
||||||
|
`http://localhost:<port in config file>`, and set a `X-Canonical-Origin` header
|
||||||
|
for all requests coming through to the URL for your instance. For example, if
|
||||||
|
your instance is at https://pixwhile.example.com, you should set the header to
|
||||||
|
`https://pixwhile.example.com`.
|
||||||
|
|
||||||
|
## Running
|
||||||
|
|
||||||
|
Run `./path/to/repository/build/pixwhile` with the path to your copied config
|
||||||
|
file as an argument
|
Loading…
Reference in New Issue