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