Enable trailing slash mode for easier Apache deployment (MFM) (#29)

* fix: enable trailing slash build output to appease Apache

* fix: link should not be relative

* fix: remove GH specific build stuff, explicitly show adapter default settings, disable strict mode, unset fallback since we don't want an SPA

* doc: add a README.md for deploy scripts, mention the trailing slash issue in HACKING.md

* fix: link should not be relative

* fix: enable trailing slash mode to appease MFM Apache

Author: teauxfu

HACKING.md

@@ -91,6 +91,10 @@ especially if you're getting a weird type error that seems wrong, give a shot ju
 
 for main content included in a page, we use `enhanced:img` wherever possible, including with a hero image optionall specified in the frontmatter of blog posts. however, it s
 
+### Quirks with Apache
+
+On moving to MFM hosting, we ran into an issue with our build output not matching the directory structure that Apache expects. We fixed that by enabling this https://svelte.dev/docs/kit/page-options#trailingSlash
+
 ### Useful links
 
 action network css examples

scripts/README.md

@@ -0,0 +1,25 @@
+# Scripts
+
+These scripts can be used to push a deployment to MFM, if you have valid credentials. Usually changes should go through a pull request, and let the workflow handle build and deployment. These scripts are here as documentation, to help illustrate what the workflow is actually doing, and also as an escape hatch if you need to push a hotfix without waiting for a PR merge. 
+
+Be careful, as using these will affect the production instance. Test your build locally before deploying. 
+
+If you are using `mise`, you can run these scripts using environment variables from a local `.env` file. 
+
+`mise exec -- bash .\scripts\deploy.sh`
+
+or on Windows
+
+`mise exec -- pwsh .\scripts\deploy.ps1`
+
+and the `.env` in your project root might look like 
+
+```
+export MFM_USER=
+export MFM_PASSWORD=
+export MFM_SSH_KEY_PATH=path\\to\\key
+export MFM_SSH_HOST=shell.mayfirst.org
+export MFM_SSH_PORT=22
+export MFM_SCP_PATH=web
+```
+

src/routes/+layout.ts

@@ -1,3 +1,5 @@
 // this line is required to use static site generation
 // https://svelte.dev/docs/kit/adapter-static
-export const prerender = true;
+export const prerender = true;
+// our MFM host is Apache, enable trailing slash to conform to its expectation for an index.html at each route
+export const trailingSlash = 'always';

src/routes/campaigns/our-work.md

@@ -15,4 +15,4 @@ The Chevron corporation supplies Israel’s war machine with energy and massive
 
 ## 🥖🌹 FITE 
 
-[Famine Is The Enemy (FITE)](./fite/) is an independent mutual aid organization run mostly by Baton Rouge DSA members. It serves food each Saturday from 12-1pm at N 14th Street Park. FITE is interested in expanding its work into clothes and healthcare distribution as well as embracing the true meaning of mutual aid through community education and empowerment. [Donate and learn more here.](./fite/)
+[Famine Is The Enemy (FITE)](/fite/) is an independent mutual aid organization run mostly by Baton Rouge DSA members. It serves food each Saturday from 12-1pm at N 14th Street Park. FITE is interested in expanding its work into clothes and healthcare distribution as well as embracing the true meaning of mutual aid through community education and empowerment. [Donate and learn more here.](/fite/)

svelte.config.js

@@ -20,11 +20,16 @@ const config = {
 	preprocess: [vitePreprocess(), mdsvex(mdsvexOptions)],
 	kit: {
 		adapter: adapter({
-			fallback: '404.html'
+			pages: 'build',
+			assets: 'build',
+			fallback: undefined,
+			precompress: false,
+			// setting strict to false so that it doesn't complain about our /api routes
+			strict: false
 		}),
-		// have to set this to make the GH workflow work
 		paths: {
-			base: process.argv.includes('dev') ? '' : process.env.BASE_PATH
+			base: '',
+			assets: ''
 		},
 		prerender: {
 			handleHttpError: ({ path, referrer, message }) => {