added links to all the READMEs
parent
a6a6899e93
commit
514bdd618e
32
README.md
32
README.md
|
@ -57,27 +57,29 @@ This section has moved. Look in the files or their documentation below.
|
||||||
```
|
```
|
||||||
|
|
||||||
# Individual documentation for each file
|
# Individual documentation for each file
|
||||||
### [DIR] policies
|
### [[DIR] policies](./policies)
|
||||||
This folder contains the documents from which our policy pages (privacy policy, TOS, etc) will be built in the future.
|
This folder contains the documents from which our policy pages (privacy policy, TOS, etc) will be built in the future.
|
||||||
### [DIR] threadr
|
### [[DIR] threadr](./threadr)
|
||||||
This folder contains all the files that are parts of ThreadR directly
|
This folder contains all the files that are parts of ThreadR directly
|
||||||
### admin.php
|
### [admin.php](./admin.php)
|
||||||
This is the file that is shown on the internal admin page. It will contain a list of users, forums, threads, etc.
|
This is the file that is shown on the internal admin page. It will contain a list of users, forums, threads, etc.
|
||||||
At the moment, it is just a convenient way to access the other internal administration tools.
|
At the moment, it is just a convenient way to access the other internal administration tools.
|
||||||
This is not directly a part of ThreadR.
|
This is not directly a part of ThreadR.
|
||||||
### default.html
|
### [default.html](./default.html)
|
||||||
The main index.html on the server. It redirects to ThreadR.
|
The main index.html on the server. It redirects to ThreadR.
|
||||||
### deployment_script.sh
|
### [deployment_script.sh](./deployment_script.sh)
|
||||||
This script is executed each time (well... if Gitea decides to actually run the WebHook) the repository gets pushed.
|
This script is executed each time (well... if Gitea decides to actually run the WebHook) the repository gets pushed.
|
||||||
It contains the commands to execute the code variable replcement system and some other useful tasks.
|
It contains the commands to execute the code variable replcement system and some other useful tasks.
|
||||||
It’s working directory is the root of the git repository.
|
It’s working directory is the root of the git repository.
|
||||||
If you want to know more: It is commented. Just look at it.
|
If you want to know more: It is commented. Just look at it.
|
||||||
### icon.png
|
### [icon.png](./icon.png)
|
||||||
Well, that’s a story about developers looking at the documentation and realizing what this is for...
|
Well, that’s a story about developers looking at the documentation and realizing what this is for...
|
||||||
I (Jan) intended it as the icon file for the tab icon but some folks put another icon elsewhere. Just ignore it. Maybe, one time, I will find a use for it.
|
I (Jan) intended it as the icon file for the tab icon but some folks put another icon elsewhere. Just ignore it. Maybe, one time, I will find a use for it.
|
||||||
### index.html
|
### [index.html](./index.html)
|
||||||
This was originally intended to be our index file. Turns out, we even need PHP on our index, so this one became another redirect to the new ThreadR index.php.
|
This was originally intended to be our index file. Turns out, we even need PHP on our index, so this one became another redirect to the new ThreadR index.php.
|
||||||
### strassenkind.php, internal.css, commands_status.conf, commands_ondemand.conf, commands_git.conf
|
|
||||||
|
DEPRECATED: We don’t have a /common directory anymore and therefore this is no longer needed. To be removed.
|
||||||
|
### [strassenkind.php](./strassenkind.php), [internal.css](./internal.css), [commands_status.conf](./commands_status.conf), [commands_ondemand.conf](./commands_ondemand.conf), [commands_git.conf](./commands_git.conf)
|
||||||
The internal status page. strassenkind.php is the index, internal.css is the stylesheet strassenkind.php uses
|
The internal status page. strassenkind.php is the index, internal.css is the stylesheet strassenkind.php uses
|
||||||
and the .conf files are lists of commands to be executed by the status page. The status page auto-refreshes to display up-to-date information on the commands in commands_status.conf.
|
and the .conf files are lists of commands to be executed by the status page. The status page auto-refreshes to display up-to-date information on the commands in commands_status.conf.
|
||||||
It is advised to put commands that have a high disk usage or start/stop/restart/reload system services etc. on the commands_ondemand.conf file as the ondemand status page does not auto-refresh.
|
It is advised to put commands that have a high disk usage or start/stop/restart/reload system services etc. on the commands_ondemand.conf file as the ondemand status page does not auto-refresh.
|
||||||
|
@ -94,18 +96,22 @@ cd web-deployment
|
||||||
exit
|
exit
|
||||||
logout
|
logout
|
||||||
```
|
```
|
||||||
### README.md
|
### [README.md](./README.md)
|
||||||
this file
|
this file
|
||||||
### run-once-script.sh
|
### [run-once-script.sh](./run-once-script.sh)
|
||||||
This script will be executed each time it is altered and pushed. Make sure to remove everything the previous user added before using it to not run these commands again.
|
This script will be executed each time it is altered and pushed. Make sure to remove everything the previous user added before using it to not run these commands again.
|
||||||
Leave the bang (#! comment) and the bottom part that has been commented to instruct you to leave it there.
|
Leave the bang (#! comment) and the bottom part that has been commented to instruct you to leave it there.
|
||||||
### variable_grabbler.py
|
|
||||||
|
DEPRECATED: This file depends on things being placed outside of the repository which will cause issues with the deployment system in the future. To be removed.
|
||||||
|
### [variable_grabbler.py](./variable_grabbler.py)
|
||||||
This is the code variable replacer. It takes two arguments: The configuration file to be used and the file to be worked on.
|
This is the code variable replacer. It takes two arguments: The configuration file to be used and the file to be worked on.
|
||||||
The configuration file contains a json which defines replacement string for each code variable in the format `"<VARNAME>":"<String>"`. Code variables are preceeded and followed by a % sign in code but this is not the case in the configuration.
|
The configuration file contains a json which defines replacement string for each code variable in the format `"<VARNAME>":"<String>"`. Code variables are preceeded and followed by a % sign in code but this is not the case in the configuration.
|
||||||
Also, they must be capitalized in code.
|
Also, they must be capitalized in code.
|
||||||
An alternative option to providing a string in the config is to add arrays defining files or commands (Commands are not implemented yet.). Format: `"<VARNAME>":["<file|exec>","<filepath|command>"]
|
An alternative option to providing a string in the config is to add arrays defining files or commands (Commands are not implemented yet.). Format: `"<VARNAME>":["<file|exec>","<filepath|command>"]
|
||||||
Read the source code for further information.
|
Read the source code for further information.
|
||||||
### variable_grabbler.pass*.json
|
|
||||||
|
NOTICE: This file (or rather a more up-to-date version of it) will be moved to a new repository containing the deployment system.
|
||||||
|
### [variable_grabbler.pass0.json](./variable_grabbler.pass0.json), [variable_grabbler.pass1.json](./variable_grabbler.pass1.json), [variable_grabbler.pass2.json](./variable_grabbler.pass2.json)
|
||||||
These are the the config files for variable_grabbler.py.
|
These are the the config files for variable_grabbler.py.
|
||||||
A short description of what the variables do and where they should go:
|
A short description of what the variables do and where they should go:
|
||||||
* `%NAVBAR%` (in HTML part of PHP file) → the Navbar, also includes an automatic logout-function if the user is in a place where they should never be logged in (triggered by absence of the $login variable)
|
* `%NAVBAR%` (in HTML part of PHP file) → the Navbar, also includes an automatic logout-function if the user is in a place where they should never be logged in (triggered by absence of the $login variable)
|
||||||
|
@ -117,6 +123,6 @@ A short description of what the variables do and where they should go:
|
||||||
* `%CONTENT_DIR%` (anywhere in code) → the path to the ThreadR directory (without domain name)
|
* `%CONTENT_DIR%` (anywhere in code) → the path to the ThreadR directory (without domain name)
|
||||||
* `%STYLESHEET%` (in HTML) → adds the tag linking the stylesheet
|
* `%STYLESHEET%` (in HTML) → adds the tag linking the stylesheet
|
||||||
* `%REQUIRE_LOGIN%` (in PHP code, before any non-header data is sent to client) → sends users to the login page if they are not logged in
|
* `%REQUIRE_LOGIN%` (in PHP code, before any non-header data is sent to client) → sends users to the login page if they are not logged in
|
||||||
### navbar.template, banner_cookies.template
|
### [navbar.template](./navbar.template), [banner_cookies.template](./banner_cookies.template)
|
||||||
file templates for variables from the code variable replacement system
|
file templates for variables from the code variable replacement system
|
||||||
|
|
||||||
|
|
|
@ -1,9 +1,9 @@
|
||||||
# Short documentation of each file
|
# Short documentation of each file
|
||||||
### cookie_policy.md
|
### [cookie_policy.md](./cookie_policy.md)
|
||||||
the cookie policy (markdown)
|
the cookie policy (markdown)
|
||||||
### anonymous_terms_and_conditions.md
|
### [anonymous_terms_and_conditions.md](./anonymous_terms_and_conditions.md)
|
||||||
the TOS for anonymous users (markdown)
|
the TOS for anonymous users (markdown)
|
||||||
### terms_and_conditions.md
|
### [terms_and_conditions.md](./terms_and_conditions.md)
|
||||||
the TOS (markdown)
|
the TOS (markdown)
|
||||||
### README.md
|
### [README.md](./README.md)
|
||||||
this file
|
this file
|
||||||
|
|
|
@ -1,31 +1,31 @@
|
||||||
# Short documentation of each file
|
# Short documentation of each file
|
||||||
### [DIR] about
|
### [[DIR] about](./about)
|
||||||
contains the about us page
|
contains the about us page
|
||||||
### [DIR] board
|
### [[DIR] board](./board)
|
||||||
contains the files needed to display a board
|
contains the files needed to display a board
|
||||||
### [DIR] boards
|
### [[DIR] boards](./boards)
|
||||||
contains the files for the board list
|
contains the files for the board list
|
||||||
### [DIR] img
|
### [[DIR] img](./img)
|
||||||
the directory that contains images that are part of the WebSite itself (no user content)
|
the directory that contains images that are part of the website itself (no user content)
|
||||||
### [DIR] login
|
### [[DIR] login](./login)
|
||||||
everything that is needed to log in a user
|
everything that is needed to log in a user
|
||||||
### [DIR] logout
|
### [[DIR] logout](./logout)
|
||||||
the logout process
|
the logout process
|
||||||
### [DIR] news
|
### [[DIR] news](./news)
|
||||||
a page displaying a special board that is write-protected and shows updates about ThreadR
|
a page displaying a special board that is write-protected and shows updates about ThreadR
|
||||||
### [DIR] profile
|
### [[DIR] profile](./profile)
|
||||||
profile pages and profile settings
|
profile pages and profile settings
|
||||||
### [DIR] signup
|
### [[DIR] signup](./signup)
|
||||||
the signup process
|
the signup process
|
||||||
### [DIR] userhome
|
### [[DIR] userhome](./userhome)
|
||||||
the user’s feed
|
the user’s feed
|
||||||
### accept_cookie.php
|
### [accept_cookie.php](./accept_cookie.php)
|
||||||
redirect immediately back to where the user came from but sets a cookie that says 'You accept cookies.'
|
redirect immediately back to where the user came from but sets a cookie that says 'You accept cookies.'
|
||||||
$_GET variables:
|
$_GET variables:
|
||||||
* from: the url the user came from after urlencode() was used on it
|
* from: the url the user came from after urlencode() was used on it
|
||||||
### index.php
|
### [index.php](./index.php)
|
||||||
the homepage
|
the homepage
|
||||||
### README.md
|
### [README.md](./README.php)
|
||||||
this file
|
this file
|
||||||
### style.css
|
### [style.css](./style.css)
|
||||||
the stylesheet used on every ThreadR site
|
the stylesheet used on every ThreadR site
|
||||||
|
|
|
@ -1,5 +1,5 @@
|
||||||
# Short documentation of all files
|
# Short documentation of all files
|
||||||
### index.php
|
### [index.php](./index.php)
|
||||||
Self-Explanatory
|
Self-Explanatory
|
||||||
### README.md
|
### [README.md](./README.md)
|
||||||
this file
|
this file
|
||||||
|
|
|
@ -1,19 +1,19 @@
|
||||||
# A short overview of the files:
|
# A short overview of the files:
|
||||||
### index.php
|
### [index.php](./index.php)
|
||||||
Somewhat obvious...
|
Somewhat obvious...
|
||||||
$_GET values:
|
$_GET values:
|
||||||
* id → the board id
|
* id → the board id
|
||||||
* action → what action file should be loaded in the bottom section (see below)
|
* action → what action file should be loaded in the bottom section (see below)
|
||||||
* valid actions: [not present], post, submit, edit
|
* valid actions: [not present], post, submit, edit
|
||||||
### board.php
|
### [board.php](./board.php)
|
||||||
the top part of a board page, displays the posts, loaded via include()
|
the top part of a board page, displays the posts, loaded via include()
|
||||||
### post.php
|
### [post.php](./post.php)
|
||||||
one of the action files for the bottom of the page, displays a form to add a post, loaded via include()
|
one of the action files for the bottom of the page, displays a form to add a post, loaded via include()
|
||||||
### submit.php
|
### [submit.php](./submit.php)
|
||||||
displays a message in the bottom of the page and submits a new post, loaded via include()
|
displays a message in the bottom of the page and submits a new post, loaded via include()
|
||||||
### edit.php
|
### [edit.php](./edit.php)
|
||||||
? [Will look into it later, seems not to do very much ATM]
|
? [Will look into it later, seems not to do very much ATM]
|
||||||
### default.php
|
### [default.php](./default.php)
|
||||||
displays a button giving the user the option to post something
|
displays a button giving the user the option to post something
|
||||||
### README.md
|
### [README.md](./README.md)
|
||||||
this file
|
this file
|
||||||
|
|
|
@ -1,5 +1,5 @@
|
||||||
# Short description of each file
|
# Short description of each file
|
||||||
### index.php
|
### [index.php](./index.php)
|
||||||
obvious, hopefully
|
obvious, hopefully
|
||||||
### README.md
|
### [README.md](./README.md)
|
||||||
this file
|
this file
|
||||||
|
|
|
@ -1,7 +1,7 @@
|
||||||
# Short documentation of all files
|
# Short documentation of all files
|
||||||
### index.html
|
### [index.html](./index.html)
|
||||||
This is my usual nope.html to prevent kiddies from poking at my files. It just redirects. There is no real security benefit to it though as it does not even prevent `wget -r`.
|
This is my usual nope.html to prevent kiddies from poking at my files. It just redirects. There is no real security benefit to it though as it does not even prevent `wget -r`.
|
||||||
### *.{svg,png,jpg}
|
### *.{svg,png,jpg}
|
||||||
images that are used on the page
|
images that are used on the page
|
||||||
### README.md
|
### [README.md](./README.md)
|
||||||
this file
|
this file
|
||||||
|
|
|
@ -1,7 +1,7 @@
|
||||||
# A short description of each file
|
# A short description of each file
|
||||||
### index.php
|
### [index.php](./index.php)
|
||||||
should be obvious, accepts a $_GET variable to display error messages: error=<credentials|session>
|
should be obvious, accepts a $_GET variable to display error messages: error=<credentials|session>
|
||||||
### README.md
|
### [README.md](./README.md)
|
||||||
this file
|
this file
|
||||||
### redirect.php
|
### [redirect.php](./redirect.php)
|
||||||
does some tasks for login and redirects to the user’s personal feed page
|
does some tasks for login and redirects to the user’s personal feed page
|
||||||
|
|
|
@ -1,5 +1,5 @@
|
||||||
# Short documentation of all files
|
# Short documentation of all files
|
||||||
### index.php
|
### [index.php](./index.php)
|
||||||
Self-Explanatory
|
Self-Explanatory
|
||||||
### README.md
|
### [README.md](./README.md)
|
||||||
this file
|
this file
|
||||||
|
|
|
@ -1,5 +1,5 @@
|
||||||
# Short description of each file
|
# Short description of each file
|
||||||
### index.php
|
### [index.php](./index.php)
|
||||||
Well, guess what?
|
Well, guess what?
|
||||||
### README.md
|
### [README.md](./README.md)
|
||||||
this file
|
this file
|
||||||
|
|
|
@ -1,10 +1,10 @@
|
||||||
# Short documentation of each file
|
# Short documentation of each file
|
||||||
### index.php
|
### [index.php](./index.php)
|
||||||
Fairly obvious, if you ask me.
|
Fairly obvious, if you ask me.
|
||||||
Accepts a $_GET variable: action=<[not present]|edit>
|
Accepts a $_GET variable: action=<[not present]|edit>
|
||||||
### default.php
|
### [default.php](./default.php)
|
||||||
shown by default, loaded via include()
|
shown by default, loaded via include()
|
||||||
### edit.php
|
### [edit.php](./edit.php)
|
||||||
profile edit page, loaded via include()
|
profile edit page, loaded via include()
|
||||||
### README.md
|
### [README.md](./README.md)
|
||||||
this file
|
this file
|
||||||
|
|
|
@ -1,8 +1,8 @@
|
||||||
# Short description for each file
|
# Short description for each file
|
||||||
### [DIR] verify-email
|
### [[DIR] verify-email](./verify-email)
|
||||||
the folder containing the email verification page
|
the folder containing the email verification page
|
||||||
### index.php
|
### [index.php](./index.php)
|
||||||
You can figure that out on your own.
|
You can figure that out on your own.
|
||||||
Interesting fact about this page: Will force-logout the user without notice.
|
Interesting fact about this page: Will force-logout the user without notice.
|
||||||
### README.md
|
### [README.md](./README.md)
|
||||||
this file
|
this file
|
||||||
|
|
|
@ -1,7 +1,7 @@
|
||||||
# Files
|
# Files
|
||||||
### index.php
|
### [index.php](./index.php)
|
||||||
obvious
|
obvious
|
||||||
### redirect.php
|
### [redirect.php](./redirect.php)
|
||||||
activates the user after the email has been verified
|
activates the user after the email has been verified
|
||||||
### README.md
|
### [README.md](./README.php)
|
||||||
this file
|
this file
|
||||||
|
|
|
@ -1,5 +1,5 @@
|
||||||
## Short documentation of all files
|
## Short documentation of all files
|
||||||
### index.php
|
### [index.php](./index.php)
|
||||||
Self-Explanatory
|
Self-Explanatory
|
||||||
### README.md
|
### [README.md](./README.md)
|
||||||
this file
|
this file
|
||||||
|
|
Loading…
Reference in New Issue