wowee friendlier readme

README.md

@@ -34,7 +34,79 @@ PORT=1234 node build
 
 ## Configuration
 
-Currently, there isn't a proper configuration system - this is not yet made to be hosted by anyone by me. You can head into [`src/lib/config.js`](https://git.oat.zone/oat/cohost-blogger/src/lib/config.js) for all instance-specific configuration, but this will be expanded into a proper system eventually:tm.
+Currently, there isn't a proper configuration system - this is not yet made to be hosted by anyone by me. You can head into [`src/lib/config.js`](https://git.oat.zone/oat/cohost-blogger/src/branch/main/src/lib/config.js) for all instance-specific configuration, but this will be expanded into a proper system eventually:tm:.
+
+## Writing notes
+
+There are a few different quirks from Cohost's official parser you must keep in mind:
+
+- Most sanitization rulesets do not apply to posts
+  - This means that classes and other otherwise removed attributes are kept
+    - Classes are isolated in the app, however, so don't be afraid of using classes if you must
+  - They still apply to comments
+- Isolation is a bit more loose
+- The background of the post can be dark depending on the user's theme
+
+### Cohost-exclusive content
+
+You may specify Cohost-exclusive content like so:
+
+```html
+<div class="cohost-blogger-ignore">
+  Everything inside of here is hidden on cohost-blogger!
+</div>
+```
+
+### Metadata
+
+cohost-blogger metadata may be specified like so:
+
+```html
+<!--@cohost-blogger-meta
+slug: so-how-are-there-eyes-in-the-water-exactly
+published-at: 2023-01-24
+-->
+```
+
+It may be inserted at any point in the post, as long as it is _a seperate block_ - prepended and appended with 2 newlines.
+
+Currently, only `slug` and `published-at` are valid keys, however more may be added in the future. `slug` specifies the URL, while `published-at` overrides the publication date for reuploaded posts.
+
+### Videos
+
+Currently, only direct links and YouTube links are supported as videos. You embed them the same way you do on Cohost - by putting them in plaintext in their own paragraph.
+
+**Direct link videos autoplay.** This may start playing audio in certain cases! Please append `?autoplay=false` to video URLs with sound.
+
+## Development notes
+
+### Markdown processing
+
+Most Markdown processing code is borrowed from Cohost itself. You can download its partial source code [from its sourcemaps](https://cohost.org/mintexists/post/635463-wrote-a-little-scrip), if you wish to reference it
+
+### Nix Flake NPM dependencies
+
+Each time you add, remove or otherwise modify an NPM dependency, you **must** update the hash in the Nix Flake:
+
+1. Replace the dependency hash in `flake.nix` with a fake one:
+
+    ```nix
+    npmDepsHash = pkgs.lib.fakeHash;
+    ```
+
+2. Run `nix run` to attempt to build the package. It will fail, giving you an error that looks like this:
+
+    ```
+    error: hash mismatch in fixed-output derivation '/nix/store/h6s1rmcyrllqgqmrmhgmzgf2xkhws20r-cohost-blogger-0.0.1-npm-deps.drv':
+         specified: sha256-AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA=
+            got:    sha256-hzn0sjxcysxe++IPyhKE/syx3S1Nh2hKGcjvS6UaLvY=
+    ```
+
+3. Replace the dependency hash with the expected hash:
+
+    ```nix
+    npmDepsHash = "sha256-hzn0sjxcysxe++IPyhKE/syx3S1Nh2hKGcjvS6UaLvY=";
+    ```
 
 ## Attributions
 

flake.nix

@@ -18,7 +18,7 @@
             pname = "cohost-blogger";
             inherit (package) version;
 
-            npmDepsHash = "sha256-pcw+b+IFUG6w07sJ/UN0cPZfvL3oBrSqQBiVhMGquDU=";
+            npmDepsHash = "sha256-hzn0sjxcysxe++IPyhKE/syx3S1Nh2hKGcjvS6UaLvY=";
 
             doCheck = true;
 

src/lib/markdown/processors.js

@@ -90,12 +90,12 @@ export function makeLazyEmbeds(hast) {
         tagName: 'video',
         properties: {
           src: url.href,
-          autoplay: 'true',
-          playsinline: 'true',
           // since we're not able to get external metadata, and we don't want to
           // make _all_ videos autoplay, we have to scan the searchParams for
           // autoplay=false. this sucks! it's the best we can do
-          loop: (url.searchParams.get('autoplay') !== 'false').toString(),
+          autoplay: (url.searchParams.get('autoplay') !== 'false') ? 'true' : undefined,
+          loop: 'true',
+          playsinline: 'true',
           style: 'width:100%;max-width:600px',
           controls: 'true'
         },