chronoter 0.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +118 -0
- package/README.npm.md +118 -0
- package/dist/cli.js +5 -0
- package/package.json +33 -0
package/README.md
ADDED
|
@@ -0,0 +1,118 @@
|
|
|
1
|
+
# Chronoter
|
|
2
|
+
|
|
3
|
+
MDX-based documentation site generator with development server and Hot Module Replacement (HMR) support.
|
|
4
|
+
|
|
5
|
+
## Features
|
|
6
|
+
|
|
7
|
+
- **MDX Support** - Write documentation using MDX (Markdown + JSX)
|
|
8
|
+
- **Development Server** - Fast development server powered by Vite
|
|
9
|
+
- **Hot Module Replacement** - Instant updates without page reload
|
|
10
|
+
- **React Components** - Use React components in your documentation
|
|
11
|
+
- **Tailwind CSS** - Styled with Tailwind CSS out of the box
|
|
12
|
+
|
|
13
|
+
## Installation
|
|
14
|
+
|
|
15
|
+
```bash
|
|
16
|
+
npm install -g chronoter
|
|
17
|
+
# or
|
|
18
|
+
yarn global add chronoter
|
|
19
|
+
# or
|
|
20
|
+
pnpm add -g chronoter
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
Or use it locally in your project:
|
|
24
|
+
|
|
25
|
+
```bash
|
|
26
|
+
npm install chronoter --save-dev
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
## Quick Start
|
|
30
|
+
|
|
31
|
+
1. Create a project directory with your MDX files:
|
|
32
|
+
|
|
33
|
+
```
|
|
34
|
+
my-docs/
|
|
35
|
+
├── chronoter.config.json # Optional configuration
|
|
36
|
+
└── docs/
|
|
37
|
+
├── index.mdx
|
|
38
|
+
└── getting-started.mdx
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
2. Start the development server:
|
|
42
|
+
|
|
43
|
+
```bash
|
|
44
|
+
chronoter dev
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
3. Open your browser at `http://localhost:3000`
|
|
48
|
+
|
|
49
|
+
## Usage
|
|
50
|
+
|
|
51
|
+
### Development Server
|
|
52
|
+
|
|
53
|
+
Start the development server with HMR:
|
|
54
|
+
|
|
55
|
+
```bash
|
|
56
|
+
chronoter dev [options]
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
#### Options
|
|
60
|
+
|
|
61
|
+
| Option | Description | Default |
|
|
62
|
+
|--------|-------------|---------|
|
|
63
|
+
| `-p, --port <port>` | Server port number | `3000` |
|
|
64
|
+
| `-H, --host <host>` | Server host | `localhost` |
|
|
65
|
+
| `--no-open` | Disable automatic browser opening | Browser opens by default |
|
|
66
|
+
| `--cwd <path>` | Working directory | Current directory |
|
|
67
|
+
|
|
68
|
+
#### Examples
|
|
69
|
+
|
|
70
|
+
```bash
|
|
71
|
+
# Start on port 8080
|
|
72
|
+
chronoter dev --port 8080
|
|
73
|
+
|
|
74
|
+
# Start without opening browser
|
|
75
|
+
chronoter dev --no-open
|
|
76
|
+
|
|
77
|
+
# Start in a specific directory
|
|
78
|
+
chronoter dev --cwd ./my-docs
|
|
79
|
+
```
|
|
80
|
+
|
|
81
|
+
## Configuration
|
|
82
|
+
|
|
83
|
+
Create a `chronoter.config.json` file in your project root:
|
|
84
|
+
|
|
85
|
+
```json
|
|
86
|
+
{
|
|
87
|
+
"site": {
|
|
88
|
+
"title": "My Documentation",
|
|
89
|
+
"description": "Documentation for my project"
|
|
90
|
+
},
|
|
91
|
+
"docsDir": "docs"
|
|
92
|
+
}
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
## MDX Files
|
|
96
|
+
|
|
97
|
+
Write your documentation in MDX format:
|
|
98
|
+
|
|
99
|
+
```mdx
|
|
100
|
+
---
|
|
101
|
+
title: Getting Started
|
|
102
|
+
---
|
|
103
|
+
|
|
104
|
+
# Welcome to My Documentation
|
|
105
|
+
|
|
106
|
+
This is written in **MDX**, so you can use React components:
|
|
107
|
+
|
|
108
|
+
<MyComponent />
|
|
109
|
+
```
|
|
110
|
+
|
|
111
|
+
## Requirements
|
|
112
|
+
|
|
113
|
+
- Node.js 18.0 or higher
|
|
114
|
+
|
|
115
|
+
## License
|
|
116
|
+
|
|
117
|
+
This software is proprietary. All rights reserved.
|
|
118
|
+
Commercial use is prohibited without explicit permission from the author.
|
package/README.npm.md
ADDED
|
@@ -0,0 +1,118 @@
|
|
|
1
|
+
# Chronoter
|
|
2
|
+
|
|
3
|
+
MDX-based documentation site generator with development server and Hot Module Replacement (HMR) support.
|
|
4
|
+
|
|
5
|
+
## Features
|
|
6
|
+
|
|
7
|
+
- **MDX Support** - Write documentation using MDX (Markdown + JSX)
|
|
8
|
+
- **Development Server** - Fast development server powered by Vite
|
|
9
|
+
- **Hot Module Replacement** - Instant updates without page reload
|
|
10
|
+
- **React Components** - Use React components in your documentation
|
|
11
|
+
- **Tailwind CSS** - Styled with Tailwind CSS out of the box
|
|
12
|
+
|
|
13
|
+
## Installation
|
|
14
|
+
|
|
15
|
+
```bash
|
|
16
|
+
npm install -g chronoter
|
|
17
|
+
# or
|
|
18
|
+
yarn global add chronoter
|
|
19
|
+
# or
|
|
20
|
+
pnpm add -g chronoter
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
Or use it locally in your project:
|
|
24
|
+
|
|
25
|
+
```bash
|
|
26
|
+
npm install chronoter --save-dev
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
## Quick Start
|
|
30
|
+
|
|
31
|
+
1. Create a project directory with your MDX files:
|
|
32
|
+
|
|
33
|
+
```
|
|
34
|
+
my-docs/
|
|
35
|
+
├── chronoter.config.json # Optional configuration
|
|
36
|
+
└── docs/
|
|
37
|
+
├── index.mdx
|
|
38
|
+
└── getting-started.mdx
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
2. Start the development server:
|
|
42
|
+
|
|
43
|
+
```bash
|
|
44
|
+
chronoter dev
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
3. Open your browser at `http://localhost:3000`
|
|
48
|
+
|
|
49
|
+
## Usage
|
|
50
|
+
|
|
51
|
+
### Development Server
|
|
52
|
+
|
|
53
|
+
Start the development server with HMR:
|
|
54
|
+
|
|
55
|
+
```bash
|
|
56
|
+
chronoter dev [options]
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
#### Options
|
|
60
|
+
|
|
61
|
+
| Option | Description | Default |
|
|
62
|
+
|--------|-------------|---------|
|
|
63
|
+
| `-p, --port <port>` | Server port number | `3000` |
|
|
64
|
+
| `-H, --host <host>` | Server host | `localhost` |
|
|
65
|
+
| `--no-open` | Disable automatic browser opening | Browser opens by default |
|
|
66
|
+
| `--cwd <path>` | Working directory | Current directory |
|
|
67
|
+
|
|
68
|
+
#### Examples
|
|
69
|
+
|
|
70
|
+
```bash
|
|
71
|
+
# Start on port 8080
|
|
72
|
+
chronoter dev --port 8080
|
|
73
|
+
|
|
74
|
+
# Start without opening browser
|
|
75
|
+
chronoter dev --no-open
|
|
76
|
+
|
|
77
|
+
# Start in a specific directory
|
|
78
|
+
chronoter dev --cwd ./my-docs
|
|
79
|
+
```
|
|
80
|
+
|
|
81
|
+
## Configuration
|
|
82
|
+
|
|
83
|
+
Create a `chronoter.config.json` file in your project root:
|
|
84
|
+
|
|
85
|
+
```json
|
|
86
|
+
{
|
|
87
|
+
"site": {
|
|
88
|
+
"title": "My Documentation",
|
|
89
|
+
"description": "Documentation for my project"
|
|
90
|
+
},
|
|
91
|
+
"docsDir": "docs"
|
|
92
|
+
}
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
## MDX Files
|
|
96
|
+
|
|
97
|
+
Write your documentation in MDX format:
|
|
98
|
+
|
|
99
|
+
```mdx
|
|
100
|
+
---
|
|
101
|
+
title: Getting Started
|
|
102
|
+
---
|
|
103
|
+
|
|
104
|
+
# Welcome to My Documentation
|
|
105
|
+
|
|
106
|
+
This is written in **MDX**, so you can use React components:
|
|
107
|
+
|
|
108
|
+
<MyComponent />
|
|
109
|
+
```
|
|
110
|
+
|
|
111
|
+
## Requirements
|
|
112
|
+
|
|
113
|
+
- Node.js 18.0 or higher
|
|
114
|
+
|
|
115
|
+
## License
|
|
116
|
+
|
|
117
|
+
This software is proprietary. All rights reserved.
|
|
118
|
+
Commercial use is prohibited without explicit permission from the author.
|
package/dist/cli.js
ADDED
package/package.json
ADDED
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "chronoter",
|
|
3
|
+
"version": "0.1.0",
|
|
4
|
+
"description": "CLI for Chronoter - MDX-based documentation site generator",
|
|
5
|
+
"type": "module",
|
|
6
|
+
"bin": {
|
|
7
|
+
"chronoter": "./dist/cli.js"
|
|
8
|
+
},
|
|
9
|
+
"files": [
|
|
10
|
+
"dist",
|
|
11
|
+
"README.md"
|
|
12
|
+
],
|
|
13
|
+
"keywords": [
|
|
14
|
+
"mdx",
|
|
15
|
+
"documentation",
|
|
16
|
+
"static-site-generator",
|
|
17
|
+
"cli"
|
|
18
|
+
],
|
|
19
|
+
"license": "UNLICENSED",
|
|
20
|
+
"engines": {
|
|
21
|
+
"node": ">=18.0.0"
|
|
22
|
+
},
|
|
23
|
+
"dependencies": {
|
|
24
|
+
"@chronoter/main": "^0.1.0"
|
|
25
|
+
},
|
|
26
|
+
"devDependencies": {
|
|
27
|
+
"tsup": "^8.0.1",
|
|
28
|
+
"typescript": "^5.3.3"
|
|
29
|
+
},
|
|
30
|
+
"scripts": {
|
|
31
|
+
"build": "tsup"
|
|
32
|
+
}
|
|
33
|
+
}
|