PostText/README.md

# Post::Text

A textboard written in Perl

## Installing locally

Install dependencies:

    cpanm --installdeps .

## Running locally

Create a config file:

    cp example_post_text.conf post_text.conf

This file right now just contains a Perl hash reference. Someday it
should be YAML or XML or something better suited.

Run it in development mode:

    morbo -w assets/css/ -w public/ -w lib/ -w templates/ \
        -w script/ script/post_text

Now try requesting http://localhost:3000

## Testing

First, create a valid first thread and first remark to the first
thread. The tests rely on the existence of thread #1 and remark #1
being the first remark to that first thread. Then you can run the
tests locally:

    prove -l

## Building/running container

### Build

    podman build -t post_text .

### Tag

    podman tag post_text git.minimally.online/swaggboi/post_text

### Push

    podman push git.minimally.online/swaggboi/post_text

### Pull

    podman pull git.minimally.online/swaggboi/post_text

### Run

    podman run -dt --rm --name post_text -p 3002:3000 post_text

### Generate unit file

    podman generate systemd --files --new --name post_text

## TODOs

1. Post preview
1. There was something else but I forget...
1. CAPTCHA
1. "All new posts flagged" mode (require approval for new posts)
1. Tests for mod-only user?

## Crazy future ideas

### (Lord knows there's TODOs I could be working on...)

1. Is `remark_tally` counting hidden remarks? Tried to add a `WHERE
   NOT hidden_status` but that returns null, probably need a different
   `JOIN` which may not be worth the trouble/processing
1. Implement tripcodes (moving this down in priority due to complexity...)
1. Post thread via SMS (twil.io??)
Initial commit++ 2022-07-22 21:34:36 +00:00			`# Post::Text`

Initial commit 2022-07-22 21:22:23 +00:00			`A textboard written in Perl`
Initial commit++ 2022-07-22 21:34:36 +00:00
Add a section for install instructions and another TODO 2022-07-27 03:15:18 +00:00			`## Installing locally`

Document post_text.conf 2022-10-02 02:43:40 +00:00			`Install dependencies:`
Add a section for install instructions and another TODO 2022-07-27 03:15:18 +00:00
Implement hyperlinking to single-thread view 2022-08-22 21:33:15 +00:00			`cpanm --installdeps .`
Add a section for install instructions and another TODO 2022-07-27 03:15:18 +00:00
Create a test; add some documentation 2022-07-22 22:43:01 +00:00			`## Running locally`

Document post_text.conf 2022-10-02 02:43:40 +00:00			`Create a config file:`

			`cp example_post_text.conf post_text.conf`

			`This file right now just contains a Perl hash reference. Someday it`
			`should be YAML or XML or something better suited.`

			`Run it in development mode:`
Create a test; add some documentation 2022-07-22 22:43:01 +00:00
Moar CSS and HTML stuff 2023-05-15 02:43:13 +00:00			`morbo -w assets/css/ -w public/ -w lib/ -w templates/ \`
			`-w script/ script/post_text`
Create a test; add some documentation 2022-07-22 22:43:01 +00:00
			`Now try requesting http://localhost:3000`

			`## Testing`

Implement remark-to-remark feature; move 'last remark' above 'thread' in the post_remark view 2023-06-25 04:01:13 +00:00			`First, create a valid first thread and first remark to the first`
			`thread. The tests rely on the existence of thread #1 and remark #1`
			`being the first remark to that first thread. Then you can run the`
			`tests locally:`
Create a test; add some documentation 2022-07-22 22:43:01 +00:00
Implement hyperlinking to single-thread view 2022-08-22 21:33:15 +00:00			`prove -l`
Create a test; add some documentation 2022-07-22 22:43:01 +00:00
Dockerfile, some docs and dependency 2023-04-25 19:10:31 +00:00			`## Building/running container`

			`### Build`

			`podman build -t post_text .`

			`### Tag`

Update docs 2023-07-26 16:39:14 +00:00			`podman tag post_text git.minimally.online/swaggboi/post_text`
Dockerfile, some docs and dependency 2023-04-25 19:10:31 +00:00
			`### Push`

Update docs 2023-07-26 16:39:14 +00:00			`podman push git.minimally.online/swaggboi/post_text`
Dockerfile, some docs and dependency 2023-04-25 19:10:31 +00:00
			`### Pull`

Update docs 2023-07-26 16:39:14 +00:00			`podman pull git.minimally.online/swaggboi/post_text`
Dockerfile, some docs and dependency 2023-04-25 19:10:31 +00:00
			`### Run`

Remove `:latest` tag doesn't really do anything 2023-05-10 01:18:21 +00:00			`podman run -dt --rm --name post_text -p 3002:3000 post_text`
Dockerfile, some docs and dependency 2023-04-25 19:10:31 +00:00
			`### Generate unit file`

			`podman generate systemd --files --new --name post_text`

Initial commit++ 2022-07-22 21:34:36 +00:00			`## TODOs`

New TODOS 2023-07-06 03:26:48 +00:00			`1. Post preview`
			`1. There was something else but I forget...`
Added a lil link for plain/raw text 2023-06-28 00:55:41 +00:00			`1. CAPTCHA`
New TODO 2023-01-09 03:11:46 +00:00			`1. "All new posts flagged" mode (require approval for new posts)`
Sanitize HTML in body; enforce NOT NULL on body; template clean-up 2023-05-04 01:05:57 +00:00			`1. Tests for mod-only user?`
LOL why not?? 2022-09-01 20:00:54 +00:00
			`## Crazy future ideas`

			`### (Lord knows there's TODOs I could be working on...)`

thread->by_id() returns remark_tally and bump_tally 2023-05-13 02:15:33 +00:00			1. Is `remark_tally` counting hidden remarks? Tried to add a `WHERE
			NOT hidden_status` but that returns null, probably need a different
			`JOIN` which may not be worth the trouble/processing
Forget about tripcodes for now, remove some unnecessary things from config 2022-11-03 19:42:06 +00:00			`1. Implement tripcodes (moving this down in priority due to complexity...)`
LOL why not?? 2022-09-01 20:00:54 +00:00			`1. Post thread via SMS (twil.io??)`