Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# missing-elements.github.io

The site of the [missing-elements](https://github.com/missing-elements) web components, at <https://missing-elements.github.io>: the docs of the PDF viewer, and the pages that make H5P content with an AI chat and the [h5p-author skill](https://github.com/missing-elements/h5p-offline-player/tree/main/skills/h5p-author).
The site of the [missing-elements](https://github.com/missing-elements) web components, at <https://missing-elements.github.io>: the docs of the PDF viewer, and the pages that make H5P content with an AI chat and the [h5p-author skill](https://github.com/missing-elements/h5p-toolkit/tree/main/skills/h5p-author).

## What it serves

Expand Down Expand Up @@ -50,4 +50,4 @@ The pages run published releases, pinned exactly in [package.json](package.json)

To move a pin, change its version in `package.json`, run `pnpm install`, then `pnpm build`, and commit the lockfile with it. Dependabot opens the pull requests for the pins as their own, apart from its group for everything else, and takes a new `@missing-elements` release the day it comes out where it holds other packages back for three days: [.github/dependabot.yml](.github/dependabot.yml) and [pnpm-workspace.yaml](pnpm-workspace.yaml) say why.

The rules behind the H5P pages, and what was measured to reach them, are in [design/author.md](https://github.com/missing-elements/h5p-offline-player/blob/main/design/author.md) of h5p-offline-player, where the skill and its packages live.
The rules behind the H5P pages, and what was measured to reach them, are in [design/author.md](https://github.com/missing-elements/h5p-toolkit/blob/main/design/author.md) of h5p-toolkit, where the skill and its packages live.
2 changes: 1 addition & 1 deletion src/_data/buildCost.js
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ import { buildPackage } from "@missing-elements/h5p-author";
// A chat asked plainly for an H5P activity has to write the two files that are its content,
// content.json and h5p.json. With the h5p-author skill it writes the source, and the build writes
// those two from it. Both are counted as JSON on one line, with no layout, and in tokens at four
// characters a token, the rule design/author.md of h5p-offline-player measures by. Tokens are a
// characters a token, the rule design/author.md of h5p-toolkit measures by. Tokens are a
// model's own, so they are said as "about", to the nearest ten.
const source = JSON.parse(await readFile("src/h5p/build/sample.json", "utf8"));
const work = await mkdtemp(join(tmpdir(), "h5p-build-cost-"));
Expand Down
16 changes: 8 additions & 8 deletions src/_data/site.js
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
// The address the project answers at: the one h5p-offline-player's code of conduct and security
// The address the project answers at: the one h5p-toolkit's code of conduct and security
// policy give, and the organization's on GitHub.
const contact = "alekswebnet@gmail.com";

// Where to say how the H5P build page and the h5p-author skill went, in two ways that start from
// the same title and two questions. An email asks for no account, and a teacher may have none on
// GitHub. A new discussion in h5p-offline-player, where the author is made, is public, for someone
// GitHub. A new discussion in h5p-toolkit, where the author is made, is public, for someone
// who has one. A mail body's lines end in CRLF (RFC 6068).
const feedbackTitle = "Feedback on the H5P build page";
const feedbackBody = "What I made (the content type, and the chat that wrote the source):\n\n\nWhat went well, or wrong:\n\n";
Expand All @@ -13,7 +13,7 @@ const buildFeedback = {
`mailto:${contact}?subject=${encodeURIComponent(feedbackTitle)}` +
`&body=${encodeURIComponent(feedbackBody.replaceAll("\n", "\r\n"))}`,
github:
"https://github.com/missing-elements/h5p-offline-player/discussions/new?category=general" +
"https://github.com/missing-elements/h5p-toolkit/discussions/new?category=general" +
`&title=${encodeURIComponent(feedbackTitle)}&body=${encodeURIComponent(feedbackBody)}`,
};

Expand Down Expand Up @@ -47,7 +47,7 @@ export default {
description: "Plays .h5p files from your own URLs or from disk with no H5P server, offline too, and reports results as xAPI, cmi5 or SCORM.",
docs: "https://h5p-offline-player.vercel.app/",
docsText: "Demo",
repo: "https://github.com/missing-elements/h5p-offline-player",
repo: "https://github.com/missing-elements/h5p-toolkit",
},
],
// The tools on the home page, under the elements: built on them, in the browser, an editor or an AI
Expand All @@ -67,15 +67,15 @@ export default {
description: "Turns a .h5p file into a SCORM zip that an LMS plays and grades, in your browser.",
links: [
{ text: "Open", href: "https://h5p-offline-player.vercel.app/demo/scorm.html" },
{ text: "GitHub", href: "https://github.com/missing-elements/h5p-offline-player/tree/main/packages/embed" },
{ text: "GitHub", href: "https://github.com/missing-elements/h5p-toolkit/tree/main/packages/embed" },
],
},
{
name: "H5P Offline Player",
description: "An app you install from the browser that plays .h5p files with no network.",
links: [
{ text: "Open", href: "https://h5p-offline-player.vercel.app/app/" },
{ text: "GitHub", href: "https://github.com/missing-elements/h5p-offline-player" },
{ text: "GitHub", href: "https://github.com/missing-elements/h5p-toolkit" },
],
},
{
Expand All @@ -84,7 +84,7 @@ export default {
links: [
{ text: "VS Code Marketplace", href: "https://marketplace.visualstudio.com/items?itemName=MissingElements.h5p-preview" },
{ text: "Open VSX", href: "https://open-vsx.org/extension/MissingElements/h5p-preview" },
{ text: "GitHub", href: "https://github.com/missing-elements/h5p-offline-player/tree/main/packages/vscode" },
{ text: "GitHub", href: "https://github.com/missing-elements/h5p-toolkit/tree/main/packages/vscode" },
],
},
{
Expand All @@ -93,7 +93,7 @@ export default {
links: [
{ text: "Install", href: "https://skills.sh/missing-elements/h5p-offline-player" },
{ text: "For a chat", href: "/h5p/create-with-ai/#install" },
{ text: "GitHub", href: "https://github.com/missing-elements/h5p-offline-player/tree/main/skills" },
{ text: "GitHub", href: "https://github.com/missing-elements/h5p-toolkit/tree/main/skills" },
],
},
],
Expand Down
8 changes: 4 additions & 4 deletions src/h5p/build/build-source.ts
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,7 @@ export interface TypeFile {
* which a chat's sandbox writes with Node's `zlib.deflateRawSync` or Python's
* `zlib.compressobj(wbits=-15)` to keep the link short.
* - `#source={…}`: the JSON itself, which a chat with no code tool writes into the link, since a
* model can write its own JSON but cannot compress it (h5p-offline-player#206). The value runs to
* model can write its own JSON but cannot compress it (h5p-toolkit#206). The value runs to
* the end of the fragment, since JSON text holds `&` and `+`, and it is percent-decoded as far as
* it can be (`percentDecoded`). Base64url never holds `{` or `%`, so the forms cannot be mistaken.
* Up to three braces or brackets left open at its end are closed (`withClosers`). Its text is
Expand Down Expand Up @@ -79,7 +79,7 @@ export async function sourceFromFragment(hash: string): Promise<string | null> {
* The JSON with the braces and brackets still open at its end closed, up to three of them, or
* `null` where it ends inside a string or has more open. A model that writes a source on one line
* loses count of its closers: Haiku left one `}` out of a True/False's 600 characters
* (h5p-offline-player#206). What is closed at the end is only where the source ends, and the
* (h5p-toolkit#206). What is closed at the end is only where the source ends, and the
* build still checks every field of it.
*/
function withClosers(text: string): string | null {
Expand Down Expand Up @@ -224,7 +224,7 @@ export function matchFiles(paths: string[], chosen: File[]): { files: Record<str
* The source's own type is h5p-author's reading of it, `sourceType`: its `type` as it is or as it is
* spoken of, "interactive-book", or with none the one under `contentType` or `library`. A chat with
* no skill text writes it so, and a rule of the page's own, `type` as written, gave its first copy
* no file (h5p-offline-player#176). Below it a name counts only as it is, a listed machine name with
* no file (h5p-toolkit#176). Below it a name counts only as it is, a listed machine name with
* or without a major and minor: what reads like one, a slide's element `{ "type": "text" }`, is no
* H5P.Text.
*/
Expand All @@ -250,7 +250,7 @@ export function typesNamed(source: unknown, listed: Iterable<string>): string[]
* them the type files of the content types the source is written in. A chat in a browser has the
* skill's text and none of its files, so it guesses a type's fields, and a problem tells it one
* level's names a round. With the files beside the first problems, the weakest model tried wrote
* 42 of 46 sources right by its second reply, and 29 without them (h5p-offline-player#172). The
* 42 of 46 sources right by its second reply, and 29 without them (h5p-toolkit#172). The
* wording is the one measured.
*/
export function forTheChat(problems: Problem[], typeFiles: TypeFile[] = []): string {
Expand Down
8 changes: 4 additions & 4 deletions src/h5p/build/index.njk
Original file line number Diff line number Diff line change
Expand Up @@ -282,7 +282,7 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self' da
3,900 to 9,500 tokens for one type, where the skill's notes on a type are 200 to 3,000. For a
five-question quiz the source was 1,000 to 1,800 tokens, and the content written by hand
about 3,470
(<a href="https://github.com/missing-elements/h5p-offline-player/blob/main/design/author.md">measured</a>).
(<a href="https://github.com/missing-elements/h5p-toolkit/blob/main/design/author.md">measured</a>).
</p>
</div>
</section>
Expand All @@ -300,7 +300,7 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self' da
this page, plays it on your own site, offline, in VS Code, or in an LMS as SCORM.
</p>
<footer class="links">
<a href="https://github.com/missing-elements/h5p-offline-player/blob/main/docs/setup.md">Set up on your site</a>
<a href="https://github.com/missing-elements/h5p-toolkit/blob/main/docs/setup.md">Set up on your site</a>
<a href="https://h5p-offline-player.vercel.app/app/">Offline app</a>
<a href="https://marketplace.visualstudio.com/items?itemName=MissingElements.h5p-preview">VS Code extension</a>
<a href="https://h5p-offline-player.vercel.app/demo/scorm.html">SCORM for an LMS</a>
Expand All @@ -324,10 +324,10 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self' da
</div>
</main>

{%- set footIssues = site.github ~ "/h5p-offline-player/issues" %}
{%- set footIssues = site.github ~ "/h5p-toolkit/issues" %}
{%- set footNote %}
<p>
Built with <a href="https://github.com/missing-elements/h5p-offline-player">h5p-offline-player</a>
Built with <a href="https://github.com/missing-elements/h5p-toolkit">h5p-offline-player</a>
and <code>@missing-elements/h5p-author</code>, MIT, among
<a href="/h5p/assets/build-page-LICENSES.txt">the packages the page bundles</a>. The H5P runtime
the player loads is <a href="/h5p/assets/runtime-LICENSE.txt">GPL-3.0</a>.
Expand Down
12 changes: 6 additions & 6 deletions src/h5p/create-with-ai/index.njk
Original file line number Diff line number Diff line change
Expand Up @@ -87,13 +87,13 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self'; o
</li>
<li>
<strong>An agent with a terminal</strong>, such as Claude Code, Codex or Cursor:
<code>npx skills add missing-elements/h5p-offline-player --skill h5p-author</code>.
<code>npx skills add missing-elements/h5p-toolkit --skill h5p-author</code>.
</li>
</ul>
<p>
The zips hold h5p-author {{ skill.version }}, the release the build page runs: text files and
nothing that runs, which you can read
<a href="https://github.com/missing-elements/h5p-offline-player/tree/main/skills/h5p-author">on GitHub</a>.
<a href="https://github.com/missing-elements/h5p-toolkit/tree/main/skills/h5p-author">on GitHub</a>.
The archive holds the same release's build tool, which runs in the chat's own sandbox, and
the H5P libraries it puts in the file, each under its own licence.
</p>
Expand Down Expand Up @@ -160,7 +160,7 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self'; o
<p>
Any other H5P site takes it where it adds H5P content, H5P.com too, and Lumi opens it on your
computer. With no H5P site, h5p-offline-player plays it
<a href="https://github.com/missing-elements/h5p-offline-player/blob/main/docs/setup.md">on a site of your own</a>
<a href="https://github.com/missing-elements/h5p-toolkit/blob/main/docs/setup.md">on a site of your own</a>
or <a href="https://h5p-offline-player.vercel.app/app/">offline, in its app</a>.
</p>
</section>
Expand Down Expand Up @@ -242,7 +242,7 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self'; o
the MIT licence. The build page's code is in
<a href="https://github.com/missing-elements/missing-elements.github.io/tree/main/src/h5p/build">this site's repository</a>,
and the skill and the player are in
<a href="https://github.com/missing-elements/h5p-offline-player">h5p-offline-player</a>. The H5P
<a href="https://github.com/missing-elements/h5p-toolkit">h5p-toolkit</a>. The H5P
runtime the player loads is <a href="/h5p/assets/runtime-LICENSE.txt">GPL-3.0</a>, and the H5P
libraries in a file are each under their own licence, most MIT, as
<a href="/h5p/assets/libraries-LICENSES.txt">the pack's licence list</a> says. The packages
Expand Down Expand Up @@ -322,11 +322,11 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self'; o

</main>

{%- set footIssues = site.github ~ "/h5p-offline-player/issues" %}
{%- set footIssues = site.github ~ "/h5p-toolkit/issues" %}
{%- set footNote %}
<p>
The h5p-author skill is MIT, from
<a href="https://github.com/missing-elements/h5p-offline-player/tree/main/skills/h5p-author">h5p-offline-player</a>.
<a href="https://github.com/missing-elements/h5p-toolkit/tree/main/skills/h5p-author">h5p-toolkit</a>.
</p>
{%- endset %}
{% include "site-foot.njk" %}
8 changes: 4 additions & 4 deletions src/h5p/skill/index.njk
Original file line number Diff line number Diff line change
Expand Up @@ -41,7 +41,7 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self'; o
These are the files of h5p-author {{ skill.version }}, the release the build page at
<a href="{{ site.url }}/h5p/build/">{{ site.url }}/h5p/build/</a> runs. The skill's text is in
the zips, and on
<a href="https://github.com/missing-elements/h5p-offline-player/tree/main/skills/h5p-author">GitHub</a>.
<a href="https://github.com/missing-elements/h5p-toolkit/tree/main/skills/h5p-author">GitHub</a>.
</p>
</header>

Expand All @@ -51,7 +51,7 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self'; o
<h2 id="install-heading"><span class="step-marker"><span class="step-number">1</span></span> Install the skill</h2>
<p>
In an agent with a terminal:
<code>npx skills add missing-elements/h5p-offline-player --skill h5p-author</code>. In a chat
<code>npx skills add missing-elements/h5p-toolkit --skill h5p-author</code>. In a chat
app, from a zip:
</p>
<ul class="skill-files" role="list">
Expand All @@ -77,11 +77,11 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self'; o

</main>

{%- set footIssues = site.github ~ "/h5p-offline-player/issues" %}
{%- set footIssues = site.github ~ "/h5p-toolkit/issues" %}
{%- set footNote %}
<p>
The skill and <code>@missing-elements/h5p-author</code> are MIT, from
<a href="https://github.com/missing-elements/h5p-offline-player/tree/main/skills/h5p-author">h5p-offline-player</a>.
<a href="https://github.com/missing-elements/h5p-toolkit/tree/main/skills/h5p-author">h5p-toolkit</a>.
</p>
{%- endset %}
{% include "site-foot.njk" %}
6 changes: 3 additions & 3 deletions vite.config.ts
Original file line number Diff line number Diff line change
Expand Up @@ -82,7 +82,7 @@ function licenceFiles(): Plugin {
* A chat in a browser has the skill's text and none of its files, so it guesses how a content type
* is written, and learns one level's names from each round of problems. The build page copies the
* files of a source's own type, and of the libraries it names, for the chat along with the
* source's problems (h5p-offline-player#172). They are the release's, so they describe the fields
* source's problems (h5p-toolkit#172). They are the release's, so they describe the fields
* of the build this page runs.
*/
function typeFiles(): Plugin {
Expand Down Expand Up @@ -157,7 +157,7 @@ function sample(): Plugin {
* - `h5p-author.mjs`: the command line as one file, everything it imports bundled in by Vite, so it
* runs with nothing installed. It takes `--libraries`: the npm package's pinned pack is not with
* it. Since 0.9.8 its `--version` prints the versions from copies of the two package.json files
* Vite writes in (h5p-offline-player#198); before, it crashed, finding neither beside it. The
* Vite writes in (h5p-toolkit#198); before, it crashed, finding neither beside it. The
* build runs it and stops where it does not print the versions `index.json` says.
* - `h5p-author-LICENSES.txt`: every package bundled into `h5p-author.mjs` with its licence, as
* Vite lists them, since MIT and BSD-3-Clause ask their notices to travel with copies (zod came
Expand Down Expand Up @@ -332,7 +332,7 @@ function skillZips(): Plugin {
description: 'Privacy first, no server of ours: create H5P content from a prompt, a lesson or supplied material, as a playable .h5p (quizzes, flash cards, presentations, interactive books and more). It is built in your chat\'s own sandbox or in your browser, and nothing you make is sent to us.',
author: { name: 'Missing Elements', url: 'https://github.com/missing-elements' },
homepage: guide,
repository: 'https://github.com/missing-elements/h5p-offline-player',
repository: 'https://github.com/missing-elements/h5p-toolkit',
license: 'MIT',
keywords: ['h5p', 'quiz', 'e-learning', 'authoring'],
extensions: {
Expand Down
Loading