Skip to content

Commit

Permalink
Fix README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
qrac committed Jan 19, 2022
1 parent 06c9443 commit e4fef5f
Showing 1 changed file with 35 additions and 11 deletions.
46 changes: 35 additions & 11 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@

## About

minista(ミニスタ)は、React (TSX/JSX)で書けるスタティックサイトジェネレーターです。SaaS の web テンプレートコーディング業務を想定し、ビルド時の納品用データが綺麗(ヒューマンリーダブル)であることを重視しています。
minista(ミニスタ)は、React (TSX/JSX)で書けるスタティックサイトジェネレーターです。SaaS の web テンプレートコーディング業務を想定し、ビルド時の納品用データが綺麗(ヒューマンリーダブル)であることを重視しています。CSS と JavaScript は個別に出力されます。

- ゼロコンフィグで始められる
- React (TSX/JSX)から 100%静的な HTML を出力
Expand All @@ -24,9 +24,29 @@ minista(ミニスタ)は、React (TSX/JSX)で書けるスタティックサ

## How To Use

### [npm](https://www.npmjs.com/package/minista)
### Automatic

#### Setup
コマンド `npm init minista` を入力するだけでいくつかのテンプレートから選び始められます。テンプレートは[オフィシャル](https://github.com/qrac/create-minista/tree/main/templates)以外にも任意の GitHub パブリックリポジトリに対応していますので、自分用のテンプレートを作っておくと効率的です。

```bash
# Use interactive CLI
npm init minista

# Use Official Template
npm init minista -- --template [OFFICIAL_TEMPLATE_NAME]

# Use GitHub Template
npm init minista -- --template [GITHUB_USER]/[REPO_NAME]
npm init minista -- --template [GITHUB_USER]/[REPO_NAME]/path/to/example
```

- `create-minista`: [repo](https://github.com/qrac/create-minista) / [npm](https://www.npmjs.com/package/create-minista)

### Manual

手動でセッティングする場合は `minista` `react` `react-dom` をインストールしてください。

- `minista`: [npm](https://www.npmjs.com/package/minista)

```bash
$ npm install --save-dev minista react react-dom
Expand Down Expand Up @@ -66,7 +86,11 @@ const PageHome = () => {
export default PageHome
```

#### Develop
## Commands

### Develop

`webpack-dev-server` でプレビューします。

```bash
# Start
Expand All @@ -76,7 +100,9 @@ $ minista
Press Ctrl+C
```

#### Build
### Build

納品用にビルド。HTML には `js-beautify` 処理が施され見やすくなります。

```bash
$ minista build
Expand All @@ -86,14 +112,14 @@ $ minista build

### Comment

#### Input
`<Comment text="" />` を使うと React では作りにくい HTML コメントが残せます。

<!-- prettier-ignore -->
```js
import { render, Comment } from "minista"

const PageHome = () => {
return render( // Required!
return render(
<>
<Comment text="Comment Test" />
<h1>Hello</h1>
Expand All @@ -104,8 +130,6 @@ const PageHome = () => {
export default PageHome
```

#### output

```html
<body>
<!-- Comment Test -->
Expand All @@ -117,7 +141,7 @@ export default PageHome

納品用のサイトマップを簡単に作るコンポーネントを npm で追加可能です。納品物に追加の CSS や JavaScript をバンドルさせません。

- minista sitemap: [repo](https://github.com/qrac/minista-sitemap) / [npm](https://www.npmjs.com/package/minista-sitemap)
- `minista-sitemap`: [repo](https://github.com/qrac/minista-sitemap) / [npm](https://www.npmjs.com/package/minista-sitemap)

## Customize

Expand Down Expand Up @@ -145,7 +169,7 @@ const webpackConfig = {
plugins: [
// Replace
new MiniCssExtractPlugin({
filename: "assets/[name].css",
filename: "assets/css/[name].css",
}),
// Replace
new CopyPlugin({
Expand Down

0 comments on commit e4fef5f

Please sign in to comment.