Skip to content

Commit 75862d8

Browse files
cblanqueracblanquera
committed
moving gh pages to packages/www
1 parent d8c5b85 commit 75862d8

54 files changed

Lines changed: 2487 additions & 38 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎AGENTS.md‎

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ Edit source, not generated output:
1919
- transformer tests: `packages/idea-transformer/tests`
2020
- extension source: `language/client/src`, `language/server/src`
2121
- docs source: `specs/`
22-
- docs site templates: `scripts/templates/`
22+
- docs site builder source: `packages/www/`
2323

2424
Generated output to avoid editing by hand:
2525

@@ -55,7 +55,9 @@ yarn test
5555
yarn test:parser
5656
yarn test:transformer
5757
yarn transform
58-
yarn build:docs
58+
yarn www:build
59+
yarn www:check
60+
yarn www:serve
5961
```
6062

6163
Package-specific:
@@ -83,8 +85,8 @@ cd language && npm test
8385
Docs authoring and publishing are separate:
8486

8587
- author Markdown in `specs/`
86-
- edit page/layout styles in `scripts/templates/`
87-
- regenerate the static site into `docs/` with `yarn build:docs`
88+
- edit builder templates, fragments, styles, and assets in `packages/www/`
89+
- regenerate the static site into `docs/` with `yarn www:build`
8890

8991
Keep `README.md` lightweight. Put long-form docs in `specs/`.
9092

@@ -93,7 +95,7 @@ Keep `README.md` lightweight. Put long-form docs in `specs/`.
9395
- parser changes: `yarn test:parser`
9496
- transformer changes: `yarn test:transformer`
9597
- cross-package runtime changes: `yarn test`
96-
- docs generator/templates: `yarn build:docs`
98+
- docs generator/templates: `yarn www:build && yarn www:check`
9799
- extension changes: run the relevant `language` compile/lint/test command
98100

99101
## Agent Notes

‎docs/api/parser/Compiler/index.html‎

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,18 @@
33
<head>
44
<meta charset="utf-8" />
55
<meta name="viewport" content="width=device-width, initial-scale=1" />
6-
<meta name="description" content="Idea schema language and toolchain documentation." />
6+
<meta name="description" content="The Compiler class provides static methods for converting Abstract Syntax Tree (AST) tokens into structured JSON configurations. It serves as the bridge between parsed tokens and the final JSON output." />
77
<title>Compiler | Idea</title>
8+
<link rel="canonical" href="https://www.stackpress.io/idea/api/parser/Compiler/" />
9+
<meta property="og:title" content="Compiler | Idea" />
10+
<meta property="og:description" content="The Compiler class provides static methods for converting Abstract Syntax Tree (AST) tokens into structured JSON configurations. It serves as the bridge between parsed tokens and the final JSON output." />
11+
<meta property="og:type" content="website" />
12+
<meta property="og:url" content="https://www.stackpress.io/idea/api/parser/Compiler/" />
13+
<meta property="og:image" content="https://www.stackpress.io/idea/assets/brand/idea.png" />
14+
<meta name="twitter:card" content="summary_large_image" />
15+
<meta name="twitter:title" content="Compiler | Idea" />
16+
<meta name="twitter:description" content="The Compiler class provides static methods for converting Abstract Syntax Tree (AST) tokens into structured JSON configurations. It serves as the bridge between parsed tokens and the final JSON output." />
17+
<meta name="twitter:image" content="https://www.stackpress.io/idea/assets/brand/idea.png" />
818
<link rel="icon" type="image/png" href="../../../assets/brand/icon.png" />
919
<link id="hljs-light" rel="stylesheet" href="https://cdn.jsdelivr.net/npm/highlight.js@11.10.0/styles/github.min.css" />
1020
<link id="hljs-dark" rel="stylesheet" href="https://cdn.jsdelivr.net/npm/highlight.js@11.10.0/styles/github-dark.min.css" />

‎docs/api/parser/Exception/index.html‎

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,18 @@
33
<head>
44
<meta charset="utf-8" />
55
<meta name="viewport" content="width=device-width, initial-scale=1" />
6-
<meta name="description" content="Idea schema language and toolchain documentation." />
6+
<meta name="description" content="The Exception class extends the Exception class from `@stackpress/lib` to provide enhanced error handling specific to the idea parser library. It includes position information and better error reporting for parsing failures." />
77
<title>Exception | Idea</title>
8+
<link rel="canonical" href="https://www.stackpress.io/idea/api/parser/Exception/" />
9+
<meta property="og:title" content="Exception | Idea" />
10+
<meta property="og:description" content="The Exception class extends the Exception class from `@stackpress/lib` to provide enhanced error handling specific to the idea parser library. It includes position information and better error reporting for parsing failures." />
11+
<meta property="og:type" content="website" />
12+
<meta property="og:url" content="https://www.stackpress.io/idea/api/parser/Exception/" />
13+
<meta property="og:image" content="https://www.stackpress.io/idea/assets/brand/idea.png" />
14+
<meta name="twitter:card" content="summary_large_image" />
15+
<meta name="twitter:title" content="Exception | Idea" />
16+
<meta name="twitter:description" content="The Exception class extends the Exception class from `@stackpress/lib` to provide enhanced error handling specific to the idea parser library. It includes position information and better error reporting for parsing failures." />
17+
<meta name="twitter:image" content="https://www.stackpress.io/idea/assets/brand/idea.png" />
818
<link rel="icon" type="image/png" href="../../../assets/brand/icon.png" />
919
<link id="hljs-light" rel="stylesheet" href="https://cdn.jsdelivr.net/npm/highlight.js@11.10.0/styles/github.min.css" />
1020
<link id="hljs-dark" rel="stylesheet" href="https://cdn.jsdelivr.net/npm/highlight.js@11.10.0/styles/github-dark.min.css" />

‎docs/api/parser/Lexer/index.html‎

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,18 @@
33
<head>
44
<meta charset="utf-8" />
55
<meta name="viewport" content="width=device-width, initial-scale=1" />
6-
<meta name="description" content="Idea schema language and toolchain documentation." />
6+
<meta name="description" content="The Lexer class implements the Parser interface and provides tokenization and parsing utilities for schema code. It manages a dictionary of token definitions and handles the parsing process by matching patterns against the input code." />
77
<title>Lexer | Idea</title>
8+
<link rel="canonical" href="https://www.stackpress.io/idea/api/parser/Lexer/" />
9+
<meta property="og:title" content="Lexer | Idea" />
10+
<meta property="og:description" content="The Lexer class implements the Parser interface and provides tokenization and parsing utilities for schema code. It manages a dictionary of token definitions and handles the parsing process by matching patterns against the input code." />
11+
<meta property="og:type" content="website" />
12+
<meta property="og:url" content="https://www.stackpress.io/idea/api/parser/Lexer/" />
13+
<meta property="og:image" content="https://www.stackpress.io/idea/assets/brand/idea.png" />
14+
<meta name="twitter:card" content="summary_large_image" />
15+
<meta name="twitter:title" content="Lexer | Idea" />
16+
<meta name="twitter:description" content="The Lexer class implements the Parser interface and provides tokenization and parsing utilities for schema code. It manages a dictionary of token definitions and handles the parsing process by matching patterns against the input code." />
17+
<meta name="twitter:image" content="https://www.stackpress.io/idea/assets/brand/idea.png" />
818
<link rel="icon" type="image/png" href="../../../assets/brand/icon.png" />
919
<link id="hljs-light" rel="stylesheet" href="https://cdn.jsdelivr.net/npm/highlight.js@11.10.0/styles/github.min.css" />
1020
<link id="hljs-dark" rel="stylesheet" href="https://cdn.jsdelivr.net/npm/highlight.js@11.10.0/styles/github-dark.min.css" />

‎docs/api/parser/Tokens/index.html‎

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,18 @@
33
<head>
44
<meta charset="utf-8" />
55
<meta name="viewport" content="width=device-width, initial-scale=1" />
6-
<meta name="description" content="Idea schema language and toolchain documentation." />
6+
<meta name="description" content="Token types define the Abstract Syntax Tree (AST) structures used by the idea parser to represent parsed schema code. These types form the foundation of the parsing system, providing type-safe representations of schema elements." />
77
<title>Tokens | Idea</title>
8+
<link rel="canonical" href="https://www.stackpress.io/idea/api/parser/Tokens/" />
9+
<meta property="og:title" content="Tokens | Idea" />
10+
<meta property="og:description" content="Token types define the Abstract Syntax Tree (AST) structures used by the idea parser to represent parsed schema code. These types form the foundation of the parsing system, providing type-safe representations of schema elements." />
11+
<meta property="og:type" content="website" />
12+
<meta property="og:url" content="https://www.stackpress.io/idea/api/parser/Tokens/" />
13+
<meta property="og:image" content="https://www.stackpress.io/idea/assets/brand/idea.png" />
14+
<meta name="twitter:card" content="summary_large_image" />
15+
<meta name="twitter:title" content="Tokens | Idea" />
16+
<meta name="twitter:description" content="Token types define the Abstract Syntax Tree (AST) structures used by the idea parser to represent parsed schema code. These types form the foundation of the parsing system, providing type-safe representations of schema elements." />
17+
<meta name="twitter:image" content="https://www.stackpress.io/idea/assets/brand/idea.png" />
818
<link rel="icon" type="image/png" href="../../../assets/brand/icon.png" />
919
<link id="hljs-light" rel="stylesheet" href="https://cdn.jsdelivr.net/npm/highlight.js@11.10.0/styles/github.min.css" />
1020
<link id="hljs-dark" rel="stylesheet" href="https://cdn.jsdelivr.net/npm/highlight.js@11.10.0/styles/github-dark.min.css" />

‎docs/api/parser/Trees/index.html‎

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,18 @@
33
<head>
44
<meta charset="utf-8" />
55
<meta name="viewport" content="width=device-width, initial-scale=1" />
6-
<meta name="description" content="Idea schema language and toolchain documentation." />
6+
<meta name="description" content="The AST classes are responsible for parsing specific parts of schema code into Abstract Syntax Trees (ASTs). Each AST class handles a different type of declaration or construct in the schema language." />
77
<title>Syntax Trees | Idea</title>
8+
<link rel="canonical" href="https://www.stackpress.io/idea/api/parser/Trees/" />
9+
<meta property="og:title" content="Syntax Trees | Idea" />
10+
<meta property="og:description" content="The AST classes are responsible for parsing specific parts of schema code into Abstract Syntax Trees (ASTs). Each AST class handles a different type of declaration or construct in the schema language." />
11+
<meta property="og:type" content="website" />
12+
<meta property="og:url" content="https://www.stackpress.io/idea/api/parser/Trees/" />
13+
<meta property="og:image" content="https://www.stackpress.io/idea/assets/brand/idea.png" />
14+
<meta name="twitter:card" content="summary_large_image" />
15+
<meta name="twitter:title" content="Syntax Trees | Idea" />
16+
<meta name="twitter:description" content="The AST classes are responsible for parsing specific parts of schema code into Abstract Syntax Trees (ASTs). Each AST class handles a different type of declaration or construct in the schema language." />
17+
<meta name="twitter:image" content="https://www.stackpress.io/idea/assets/brand/idea.png" />
818
<link rel="icon" type="image/png" href="../../../assets/brand/icon.png" />
919
<link id="hljs-light" rel="stylesheet" href="https://cdn.jsdelivr.net/npm/highlight.js@11.10.0/styles/github.min.css" />
1020
<link id="hljs-dark" rel="stylesheet" href="https://cdn.jsdelivr.net/npm/highlight.js@11.10.0/styles/github-dark.min.css" />

‎docs/api/parser/index.html‎

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,18 @@
33
<head>
44
<meta charset="utf-8" />
55
<meta name="viewport" content="width=device-width, initial-scale=1" />
6-
<meta name="description" content="Idea schema language and toolchain documentation." />
6+
<meta name="description" content="These pages document the parser package and its lower-level APIs." />
77
<title>Parser API Docs | Idea</title>
8+
<link rel="canonical" href="https://www.stackpress.io/idea/api/parser/" />
9+
<meta property="og:title" content="Parser API Docs | Idea" />
10+
<meta property="og:description" content="These pages document the parser package and its lower-level APIs." />
11+
<meta property="og:type" content="website" />
12+
<meta property="og:url" content="https://www.stackpress.io/idea/api/parser/" />
13+
<meta property="og:image" content="https://www.stackpress.io/idea/assets/brand/idea.png" />
14+
<meta name="twitter:card" content="summary_large_image" />
15+
<meta name="twitter:title" content="Parser API Docs | Idea" />
16+
<meta name="twitter:description" content="These pages document the parser package and its lower-level APIs." />
17+
<meta name="twitter:image" content="https://www.stackpress.io/idea/assets/brand/idea.png" />
818
<link rel="icon" type="image/png" href="../../assets/brand/icon.png" />
919
<link id="hljs-light" rel="stylesheet" href="https://cdn.jsdelivr.net/npm/highlight.js@11.10.0/styles/github.min.css" />
1020
<link id="hljs-dark" rel="stylesheet" href="https://cdn.jsdelivr.net/npm/highlight.js@11.10.0/styles/github-dark.min.css" />

‎docs/api/transformer/Terminal/index.html‎

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,18 @@
33
<head>
44
<meta charset="utf-8" />
55
<meta name="viewport" content="width=device-width, initial-scale=1" />
6-
<meta name="description" content="Idea schema language and toolchain documentation." />
6+
<meta name="description" content="A command-line interface for processing schema files and executing transformations through terminal commands. The Terminal class provides a comprehensive CLI interface for the idea-transformer library, enabling developers to process schema files and execute transformations from the command line." />
77
<title>Terminal | Idea</title>
8+
<link rel="canonical" href="https://www.stackpress.io/idea/api/transformer/Terminal/" />
9+
<meta property="og:title" content="Terminal | Idea" />
10+
<meta property="og:description" content="A command-line interface for processing schema files and executing transformations through terminal commands. The Terminal class provides a comprehensive CLI interface for the idea-transformer library, enabling developers to process schema files and execute transformations from the command line." />
11+
<meta property="og:type" content="website" />
12+
<meta property="og:url" content="https://www.stackpress.io/idea/api/transformer/Terminal/" />
13+
<meta property="og:image" content="https://www.stackpress.io/idea/assets/brand/idea.png" />
14+
<meta name="twitter:card" content="summary_large_image" />
15+
<meta name="twitter:title" content="Terminal | Idea" />
16+
<meta name="twitter:description" content="A command-line interface for processing schema files and executing transformations through terminal commands. The Terminal class provides a comprehensive CLI interface for the idea-transformer library, enabling developers to process schema files and execute transformations from the command line." />
17+
<meta name="twitter:image" content="https://www.stackpress.io/idea/assets/brand/idea.png" />
818
<link rel="icon" type="image/png" href="../../../assets/brand/icon.png" />
919
<link id="hljs-light" rel="stylesheet" href="https://cdn.jsdelivr.net/npm/highlight.js@11.10.0/styles/github.min.css" />
1020
<link id="hljs-dark" rel="stylesheet" href="https://cdn.jsdelivr.net/npm/highlight.js@11.10.0/styles/github-dark.min.css" />

‎docs/api/transformer/Transformer/index.html‎

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,18 @@
33
<head>
44
<meta charset="utf-8" />
55
<meta name="viewport" content="width=device-width, initial-scale=1" />
6-
<meta name="description" content="Idea schema language and toolchain documentation." />
6+
<meta name="description" content="A class for loading, processing, and transforming schema files with plugin support and schema merging capabilities. The Transformer class serves as the core component of the idea-transformer library, providing comprehensive functionality for schema processing, plugin execution, and file management." />
77
<title>Transformer | Idea</title>
8+
<link rel="canonical" href="https://www.stackpress.io/idea/api/transformer/Transformer/" />
9+
<meta property="og:title" content="Transformer | Idea" />
10+
<meta property="og:description" content="A class for loading, processing, and transforming schema files with plugin support and schema merging capabilities. The Transformer class serves as the core component of the idea-transformer library, providing comprehensive functionality for schema processing, plugin execution, and file management." />
11+
<meta property="og:type" content="website" />
12+
<meta property="og:url" content="https://www.stackpress.io/idea/api/transformer/Transformer/" />
13+
<meta property="og:image" content="https://www.stackpress.io/idea/assets/brand/idea.png" />
14+
<meta name="twitter:card" content="summary_large_image" />
15+
<meta name="twitter:title" content="Transformer | Idea" />
16+
<meta name="twitter:description" content="A class for loading, processing, and transforming schema files with plugin support and schema merging capabilities. The Transformer class serves as the core component of the idea-transformer library, providing comprehensive functionality for schema processing, plugin execution, and file management." />
17+
<meta name="twitter:image" content="https://www.stackpress.io/idea/assets/brand/idea.png" />
818
<link rel="icon" type="image/png" href="../../../assets/brand/icon.png" />
919
<link id="hljs-light" rel="stylesheet" href="https://cdn.jsdelivr.net/npm/highlight.js@11.10.0/styles/github.min.css" />
1020
<link id="hljs-dark" rel="stylesheet" href="https://cdn.jsdelivr.net/npm/highlight.js@11.10.0/styles/github-dark.min.css" />

‎docs/api/transformer/index.html‎

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,18 @@
33
<head>
44
<meta charset="utf-8" />
55
<meta name="viewport" content="width=device-width, initial-scale=1" />
6-
<meta name="description" content="Idea schema language and toolchain documentation." />
6+
<meta name="description" content="These pages document the transformer runtime and CLI-oriented APIs." />
77
<title>Transformer API Docs | Idea</title>
8+
<link rel="canonical" href="https://www.stackpress.io/idea/api/transformer/" />
9+
<meta property="og:title" content="Transformer API Docs | Idea" />
10+
<meta property="og:description" content="These pages document the transformer runtime and CLI-oriented APIs." />
11+
<meta property="og:type" content="website" />
12+
<meta property="og:url" content="https://www.stackpress.io/idea/api/transformer/" />
13+
<meta property="og:image" content="https://www.stackpress.io/idea/assets/brand/idea.png" />
14+
<meta name="twitter:card" content="summary_large_image" />
15+
<meta name="twitter:title" content="Transformer API Docs | Idea" />
16+
<meta name="twitter:description" content="These pages document the transformer runtime and CLI-oriented APIs." />
17+
<meta name="twitter:image" content="https://www.stackpress.io/idea/assets/brand/idea.png" />
818
<link rel="icon" type="image/png" href="../../assets/brand/icon.png" />
919
<link id="hljs-light" rel="stylesheet" href="https://cdn.jsdelivr.net/npm/highlight.js@11.10.0/styles/github.min.css" />
1020
<link id="hljs-dark" rel="stylesheet" href="https://cdn.jsdelivr.net/npm/highlight.js@11.10.0/styles/github-dark.min.css" />

0 commit comments

Comments
 (0)