Skip to content

Commit

Permalink
update readme
Browse files Browse the repository at this point in the history
add screenshots
update description
  • Loading branch information
TimurRin committed May 30, 2024
1 parent 44857ae commit e44da7a
Show file tree
Hide file tree
Showing 6 changed files with 39 additions and 21 deletions.
54 changes: 36 additions & 18 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,9 +4,13 @@ _By Cinnabar Forge_

**DISCLAIMER**: Until version 1.0.0, all versions below should be considered unstable and are subject to change.

A small, low-opinionated static site generator for showcasing your projects.
A small, low-opinionated static site generator with sections and items.

You can change sections quantity, text, colors (dark-theme ready) and fonts for headers and text.
You can change sections quantity, text, images, colors (dark-theme ready) and fonts for headers and text.

![t2006 screenshot](sample/screenshot-readme.png)

Sample site: [page](https://timurrin.github.io/) and [repo](https://github.com/TimurRin/timurrin.github.io)

## Getting Started

Expand All @@ -18,7 +22,7 @@ Install t2006 globally using npm:
npm install -g t2006
```

This will make the `t2006` command available in your terminal.
This will make the `npx t2006` or `t2006` commands available in your terminal.

### Configuration

Expand All @@ -29,30 +33,39 @@ t2006 is driven by two main configuration files:

Both files examples can be found inside `sample` folder.

#### `data.json` structure
#### `data.json` structure from the screenshot

```json
{
"title": "My Portfolio",
"title": "Title text",
"description": "HTML meta description text",
"header": {
"name": "MY NAME"
"image": "https://dev.w3.org/SVG/tools/svgweb/samples/svg-files/why.svg",
"title": "TITLE TEXT",
"subtitle": "Subtitle text",
"about": "About text"
},
"sections": [
{
"title": "SECTION NAME",
"title": "SECTION TEXT",
"items": [
{
"name": "Text",
"name": "Line example",
"image": {
"path": "https://dev.w3.org/SVG/tools/svgweb/samples/svg-files/beacon.svg"
},
"links": [
{
"text": "example link",
"url": "https://example.com/"
}
{ "text": "link", "url": "https://example.com/" }
],
"extra": "extra text"
"extra": "extra info"
},
{
"name": "Card example",
"text": "If you need description",
"links": [
{ "text": "foo", "url": "https://example.com/" },
{ "text": "bar", "url": "https://example.com/" }
]
}
]
}
Expand All @@ -63,7 +76,7 @@ Both files examples can be found inside `sample` folder.
### Usage

```bash
t2006 --input "path/to/json/data/files" --output "path/to/html/output"
npx t2006 --input "path/to/json/data/files" --output "path/to/html/output"
```

#### `--input <path>`
Expand All @@ -78,14 +91,19 @@ t2006 --input "path/to/json/data/files" --output "path/to/html/output"

Contributions are welcome! If you find any issues or have suggestions for improvements, feel free to open an issue or create a pull request.

Clone the repository and install dependencies:
Fork, clone and install:

```bash
git clone git@github.com:cinnabar-forge/t2006.git
cd t2006
npm install
npm ci
```

### Road to 1.0

- ⚠️ Tests
- ❌ GitHub Actions script
- ❌ Special pages to present your content in the advanced way
- ❌ Localization

## License

t2006 is licensed under the ISC License - see the [LICENSE](LICENSE) file for details.
Expand Down
2 changes: 1 addition & 1 deletion cinnabar.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"cinnabarMetaVersion": 1,
"description": "A small, low-opinionated static site generator for showcasing your projects",
"description": "A small, low-opinionated static site generator with sections and items",
"name": "t2006",
"version": {
"dev": 0,
Expand Down
2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
{
"name": "t2006",
"version": "0.4.0",
"description": "A small, low-opinionated static site generator for showcasing your projects",
"description": "A small, low-opinionated static site generator with sections and items",
"keywords": [
"cli",
"static-site-generator",
Expand Down
Binary file added sample/screenshot-johndoe.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added sample/screenshot-readme.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 1 addition & 1 deletion src/cinnabar.js
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

export default {
"cinnabarMetaVersion": 1,
"description": "A small, low-opinionated static site generator for showcasing your projects",
"description": "A small, low-opinionated static site generator with sections and items",
"name": "t2006",
"version": {
"dev": 0,
Expand Down

0 comments on commit e44da7a

Please sign in to comment.