ssg-api
v1.16.10
Published
Static Site Generation TypeScript API
Downloads
760
Readme
ssg-api
TypeScript API to generate output files from input files.
It can be used to generate:
- a static website from HTML templates (but those templates can include client-side JavaScript and CSS of course).
- (and/or) other files such as configuration files (for instance converting an
.htaccess
file to anetlify.toml
file)
To install ssg-api
as a project dependency:
npm install --save ssg-api
Then import the required types to implement your own SSG code:
import { Ssg, SsgContextImpl, SsgConfig } from "ssg-api";
const config: SsgConfig = {
getOutputPath(context: SsgContext): string {
return path.join("out", context.file.name)
}
};
const ssg = new Ssg(config)
.add(firstStep)
.add(nextStep); // Write your own SSG steps!
const context = new SsgContextImpl("fr");
try {
const result = await ssg.start(context);
context.log("Completed", result);
} catch (err) {
context.error(err, context.inputFile.name, "=>", context.outputFile.name);
}
Data types
Steps
Steps can do anything. You can implement your owns, but there are predefined ones. Check the documentation for more.
Files
classDiagram
namespace fileutil {
class FileContents {
name: string
lastModified: Date
contents: string
encoding: BufferEncoding
write(): Promise<void>
read(fileName, declaredEncoding)$: FileContents
readOrNew(fileName, declaredEncoding)$: FileContents
getLang(filePath)$: FileContentsLang
getContents(fileName, declaredEncoding)$
}
class FileContentsLang {
lang: string | undefined
variants: string[]
}
}
FileContents --> FileContentsLang: lang
namespace ssg-api {
class HtmlFileContents {
lang
title: string
contents: string
document: Document
read(fileName): HtmlFileContents
serialize(): string
create(FileContents)$: HtmlFileContents
getMeta(name, document)$: string[]
getLink(rek, document)$: Link[]
}
class HtmlMeta {
url?: string
author: string[]
copyright?: string
description?: string
generator?: string
}
class HtmlLinks {
}
class Link {
type: LinkType;
text: string;
url: string;
}
}
HtmlFileContents --> HtmlMeta: meta
HtmlFileContents --> HtmlLinks: links
HtmlLinks --> Link: start?
HtmlLinks --> Link: contents?
HtmlLinks --> Link: prev?
HtmlLinks --> Link: next?
FileContents <|-- HtmlFileContents