wmantly
7d9c63b049
Air-gap:
- DynamicRecord.refreshAll() called getPublicIp() (api.ipify.org,
icanhazip.com, ifconfig.me) every 4h on a timer regardless of
whether any dynamic records were configured -- the one background
call in the repo not actually gated by feature use. Now skips the
lookup entirely when there's nothing to refresh.
- Removed the stray, unauthenticated GET /test page (a leftover
jq-repeat demo) that loaded jQuery + Mustache from external CDNs.
- Removed a dead IE<9-only html5shim script tag pointing at a domain
that no longer resolves.
Docs:
- New GET /docs (index) and /docs/:slug routes render this project's
own README, DEPLOYMENT, api.md, and docs/*.md server-side via
marked (new dependency) -- so the documentation is readable from
the running app with no route to GitHub Pages, where it otherwise
only lives. Public, no auth, same tier as the health endpoint.
- .dockerignore/Dockerfile updated: docs/, DEPLOYMENT.md, and
nodejs/api.md were previously excluded from the image entirely
("served via GitHub Pages, not from the image") -- now copied in
alongside README.md/tos.md-style, since they're needed at runtime.
65 lines
2.5 KiB
JavaScript
65 lines
2.5 KiB
JavaScript
'use strict';
|
|
|
|
const fs = require('fs');
|
|
const path = require('path');
|
|
const router = require('express').Router();
|
|
const {marked} = require('marked');
|
|
const conf = require('@simpleworkjs/conf');
|
|
const buildInfo = require('../utils/build_info');
|
|
|
|
const values = {
|
|
title: conf.environment !== 'production' ? `dev` : '',
|
|
titleIcon: conf.environment !== 'production' ? `<i class="fa-brands fa-dev"></i>` : '',
|
|
...buildInfo,
|
|
};
|
|
|
|
// Full local copy of the project's documentation, rendered server-side --
|
|
// so an operator running air-gapped (no route to GitHub Pages, where this
|
|
// content otherwise only lives) can still read it from the running app.
|
|
// An explicit slug -> file allowlist, never a user-suppliable path, so
|
|
// there's no way to make this read outside the doc set below.
|
|
const DOCS = {
|
|
overview: {title: 'Overview', file: path.join(__dirname, '../../README.md')},
|
|
deployment: {title: 'Deployment', file: path.join(__dirname, '../../DEPLOYMENT.md')},
|
|
api: {title: 'API Reference', file: path.join(__dirname, '../api.md')},
|
|
installation: {title: 'Installation', file: path.join(__dirname, '../../docs/installation.md')},
|
|
architecture: {title: 'Architecture', file: path.join(__dirname, '../../docs/architecture.md')},
|
|
docker: {title: 'Docker', file: path.join(__dirname, '../../docs/docker.md')},
|
|
contributing: {title: 'Contributing', file: path.join(__dirname, '../../docs/contributing.md')},
|
|
};
|
|
|
|
const docList = Object.entries(DOCS).map(([slug, d]) => ({slug, title: d.title}));
|
|
|
|
// README.md links its screenshots as repo-relative "docs/images/...", which
|
|
// only resolves correctly on GitHub. Serve that same folder here and rewrite
|
|
// the rendered markup to point at it absolutely, so the images work when
|
|
// read from /docs/overview too.
|
|
router.use('/images', require('express').static(path.join(__dirname, '../../docs/images')));
|
|
function fixImagePaths(html) {
|
|
return html.replace(/(["(])docs\/images\//g, '$1/docs/images/');
|
|
}
|
|
|
|
router.get('/', function(req, res) {
|
|
res.render('docs_index', {...values, docs: docList});
|
|
});
|
|
|
|
router.get('/:slug', function(req, res, next) {
|
|
const doc = DOCS[req.params.slug];
|
|
if (!doc) return next({status: 404, message: 'Doc not found'});
|
|
|
|
try {
|
|
const content = fs.readFileSync(doc.file, 'utf8');
|
|
res.render('docs_page', {
|
|
...values,
|
|
docs: docList,
|
|
currentSlug: req.params.slug,
|
|
docTitle: doc.title,
|
|
docHtml: fixImagePaths(marked(content)),
|
|
});
|
|
} catch (error) {
|
|
next(error);
|
|
}
|
|
});
|
|
|
|
module.exports = router;
|