Skip to content

Commit f1b98d6

Browse files
authored
Markdownファイルのガイドライン適応 (#1213)
1 parent e17daec commit f1b98d6

13 files changed

+202
-180
lines changed

.markdownlint.json

+5
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
{
2+
"no-inline-html": false,
3+
"line-length": false,
4+
"no-duplicate-heading": false
5+
}

docs/UX・UIデザインの方針.md

+3-1
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,6 @@
1-
## UI/UX デザイン方針
1+
# UI/UX デザイン方針
2+
3+
## 基本方針
24

35
メモ程度ですが、VOICEVOX の UX や UI のデザインの設計方針を共有します。
46

docs/フォントについて.md

+6-9
Original file line numberDiff line numberDiff line change
@@ -2,25 +2,23 @@
22

33
VOICEVOX では改変したRounded M+ 1pを使用しています。
44
具体的には、
5+
56
- ヒント情報の削除
67
- ttfからwoff2への変換
78
を行っています。
89

910
## 手順
1011

11-
1. [自家製 Rounded M+ とは](http://jikasei.me/font/rounded-mplus/about.html)からRounded M+をダウンロードします。
12-
13-
2. [ttfautohint](https://freetype.org/ttfautohint/)をインストールします。
14-
> **Note**
15-
> [ttfautohint-py](https://pypi.org/project/ttfautohint-py/)を使用しました。
16-
12+
1. [自家製 Rounded M+ とは](http://jikasei.me/font/rounded-mplus/about.html)から
13+
Rounded M+をダウンロードします。
14+
2. [ttfautohint](https://freetype.org/ttfautohint/)をインストールします。[^longnote]:[ttfautohint-py](https://pypi.org/project/ttfautohint-py/)を使用しました。
1715
3. [woff2](https://github.com/google/woff2)をビルドします。
18-
1916
4. `rounded-mplus-20150529.7z`から`rounded-mplus-1p-(ウェイト).ttf`を全て`src/fonts`に解凍します。
2017
5. ttfautohintを使用して、Rounded M+のヒント情報を削除します。名前は`Unhinted Rounded M+ 1p`とします。
2118
6. woff2を使用して、ttfからwoff2へ変換します。
2219

23-
[#1103](https://github.com/VOICEVOX/voicevox/pull/1103)の作成には以下のスクリプトを使用しました(PowerShell 7.3.1)
20+
[#1103](https://github.com/VOICEVOX/voicevox/pull/1103)の作成には
21+
以下のスクリプトを使用しました(PowerShell 7.3.1)
2422

2523
```pwsh
2624
# cwd:src/fonts
@@ -29,4 +27,3 @@ foreach ($f in gci("./*.ttf")){
2927
woff2_compress.exe "unhinted-$($f.name)"
3028
}
3129
```
32-
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,15 @@
1-
VOICEVOX のミッションは、 VOICEVOX を通じて音声合成ソフトウェアや音声合成キャラクターをより身近なものにすることです。
1+
# VOICEVOXのミッション・バリュー・ビジョン
2+
3+
## ミッション
4+
5+
VOICEVOX のミッションは、 VOICEVOX を通じて
6+
音声合成ソフトウェアや音声合成キャラクターをより身近なものにすることです。
7+
8+
## バリュー
29

310
VOICEVOX のバリューは、ユーザー数・技術力・新規性です。
411
ユーザー数の増加を最も重視します。企業に負けない技術力を目指します。新しいものを積極的に取り入れます。
512

13+
## ビジョン
14+
615
VOICEVOX のビジョンは、日本で最も使われる音声合成ソフトウェアになることです。

docs/全体構成.md

+3-3
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,5 @@
1+
# 全体構成について
2+
13
## OSS 版と製品版の違い
24

35
オープンソースとして公開されている VOICEVOX(OSS 版 VOICEVOX)と、
@@ -7,11 +9,9 @@
79
キャラクターは多くの場合 OSS と相反するライセンスを持っているため、OSS にすることができません。
810
例えば、キャラクターのライセンスによくある「公序良俗に反する利用の禁止」や「反社会的勢力の排除」は、オープンソースの定義の1つである「利用する分野に対する差別の禁止」と衝突します。
911

10-
The Open Source Definition
11-
https://opensource.org/osd
12+
[The Open Source Definition](https://opensource.org/osd)
1213

1314
そのため VOICEVOX では、キャラクターの要素(声や見た目)を含まない OSS 版と、OSS 版をもとに構築してキャラクターの要素を含めた製品版を分けて開発・配布しています。
14-
1515
<img src="./res/全体構成_OSS版と製品版の違い.svg" width="320">
1616
<!-- 修正時はエディタ側のドキュメントも要修正 -->
1717
<!-- https://github.com/VOICEVOX/.github/blob/main/profile/README.md -->

docs/細かい設計方針.md

+2-1
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,5 @@
1+
# 設計に関する詳細方針
2+
13
## Vuex とダイアログ
24

35
ダイアログは外部 API とみなし、Vuex の Store の Action 内から呼ぶことを許容しています。
@@ -23,4 +25,3 @@ StyleId は現在整数値型になっていますが、将来的にはUuidに
2325
## シングルファイルコンポーネント(SFC、`.vue`ファイル)のtemplate、script、styleの順序
2426

2527
`<template>``<script>``<style>`の順序で記述してください。
26-

package.json

+109-109
Original file line numberDiff line numberDiff line change
@@ -1,110 +1,110 @@
11
{
2-
"name": "voicevox",
3-
"version": "999.999.999",
4-
"author": "Hiroshiba Kazuyuki",
5-
"private": true,
6-
"engines": {
7-
"node": ">=16.17.0 <17",
8-
"npm": ">=8.11.0 <9"
9-
},
10-
"scripts": {
11-
"serve": "vue-cli-service serve",
12-
"build": "vue-cli-service build",
13-
"test:unit": "vue-cli-service test:unit",
14-
"test-watch:unit": "vue-cli-service test:unit --watch",
15-
"test:e2e": "playwright test",
16-
"test-watch:e2e": "vue-cli-service test:e2e --watch",
17-
"lint": "vue-cli-service lint --no-fix",
18-
"typecheck": "tsc --noEmit",
19-
"typecheck:vue-tsc": "vue-tsc --noEmit",
20-
"markdownlint": "markdownlint *.md",
21-
"fmt": "vue-cli-service lint",
22-
"electron:build": "vue-cli-service electron:build",
23-
"electron:build_pnever": "vue-cli-service electron:build --publish never",
24-
"electron:serve": "vue-cli-service electron:serve",
25-
"postinstall": "electron-builder install-app-deps",
26-
"postuninstall": "electron-builder install-app-deps",
27-
"license:generate": "node build/generateLicenses.js",
28-
"license:merge": "node build/mergeLicenses.js"
29-
},
30-
"dependencies": {
31-
"@gtm-support/vue-gtm": "1.2.3",
32-
"@quasar/extras": "1.10.10",
33-
"clone-deep": "4.0.1",
34-
"core-js": "3.12.1",
35-
"dayjs": "1.10.7",
36-
"dotenv": "16.0.0",
37-
"electron-log": "4.4.8",
38-
"electron-store": "8.1.0",
39-
"electron-window-state": "5.0.3",
40-
"encoding-japanese": "1.0.30",
41-
"glob": "8.0.3",
42-
"immer": "9.0.2",
43-
"markdown-it": "12.0.4",
44-
"move-file": "3.0.0",
45-
"multistream": "4.1.0",
46-
"quasar": "2.11.3",
47-
"semver": "7.3.5",
48-
"shlex": "2.1.2",
49-
"source-map-support": "0.5.19",
50-
"systeminformation": "5.8.0",
51-
"tree-kill": "1.2.2",
52-
"unzipper": "github:ZJONSSON/node-unzipper#341f258",
53-
"uuid": "9.0.0",
54-
"vue": "3.2.45",
55-
"vue-router": "4.0.8",
56-
"vuedraggable": "4.1.0",
57-
"vuex": "4.0.2",
58-
"zod": "3.20.2",
59-
"zod-to-json-schema": "3.20.1"
60-
},
61-
"devDependencies": {
62-
"@openapitools/openapi-generator-cli": "2.3.3",
63-
"@playwright/test": "1.23.3",
64-
"@types/chai": "4.2.18",
65-
"@types/clone-deep": "4.0.1",
66-
"@types/electron-devtools-installer": "2.2.2",
67-
"@types/encoding-japanese": "1.0.18",
68-
"@types/glob": "8.0.0",
69-
"@types/markdown-it": "12.2.0",
70-
"@types/mocha": "5.2.7",
71-
"@types/mousetrap": "1.6.8",
72-
"@types/multistream": "4.1.0",
73-
"@types/semver": "7.3.9",
74-
"@types/unzipper": "0.10.5",
75-
"@types/uuid": "8.3.4",
76-
"@typescript-eslint/eslint-plugin": "5.38.1",
77-
"@typescript-eslint/parser": "5.38.1",
78-
"@vue/cli-plugin-babel": "4.5.13",
79-
"@vue/cli-plugin-eslint": "5.0.8",
80-
"@vue/cli-plugin-router": "4.5.13",
81-
"@vue/cli-plugin-typescript": "4.5.19",
82-
"@vue/cli-plugin-unit-mocha": "4.5.13",
83-
"@vue/cli-plugin-vuex": "4.5.13",
84-
"@vue/cli-service": "4.5.13",
85-
"@vue/compiler-sfc": "3.2.45",
86-
"@vue/eslint-config-prettier": "7.0.0",
87-
"@vue/eslint-config-typescript": "11.0.2",
88-
"@vue/test-utils": "2.0.0-rc.6",
89-
"chai": "4.3.4",
90-
"chai-as-promised": "7.1.1",
91-
"electron": "20.3.3",
92-
"electron-devtools-installer": "3.2.0",
93-
"eslint": "8.24.0",
94-
"eslint-config-prettier": "8.5.0",
95-
"eslint-plugin-prettier": "3.4.0",
96-
"eslint-plugin-vue": "9.5.1",
97-
"license-checker": "25.0.1",
98-
"markdownlint": "0.23.1",
99-
"markdownlint-cli": "0.28.1",
100-
"mousetrap": "1.6.5",
101-
"prettier": "2.3.0",
102-
"sass": "1.32.13",
103-
"sass-loader": "8.0.2",
104-
"tmp": "0.2.1",
105-
"typescript": "4.8.4",
106-
"vue-cli-plugin-electron-builder": "3.0.0-alpha.4",
107-
"vue-tsc": "0.40.13",
108-
"yargs": "17.2.1"
109-
}
110-
}
2+
"name": "voicevox",
3+
"version": "999.999.999",
4+
"author": "Hiroshiba Kazuyuki",
5+
"private": true,
6+
"engines": {
7+
"node": ">=16.17.0 <17",
8+
"npm": ">=8.11.0 <9"
9+
},
10+
"scripts": {
11+
"serve": "vue-cli-service serve",
12+
"build": "vue-cli-service build",
13+
"test:unit": "vue-cli-service test:unit",
14+
"test-watch:unit": "vue-cli-service test:unit --watch",
15+
"test:e2e": "playwright test",
16+
"test-watch:e2e": "vue-cli-service test:e2e --watch",
17+
"lint": "vue-cli-service lint --no-fix",
18+
"typecheck": "tsc --noEmit",
19+
"typecheck:vue-tsc": "vue-tsc --noEmit",
20+
"markdownlint": "markdownlint --ignore node_modules/ --ignore dist/ --ignore dist_electron/ ./",
21+
"fmt": "vue-cli-service lint",
22+
"electron:build": "vue-cli-service electron:build",
23+
"electron:build_pnever": "vue-cli-service electron:build --publish never",
24+
"electron:serve": "vue-cli-service electron:serve",
25+
"postinstall": "electron-builder install-app-deps",
26+
"postuninstall": "electron-builder install-app-deps",
27+
"license:generate": "node build/generateLicenses.js",
28+
"license:merge": "node build/mergeLicenses.js"
29+
},
30+
"dependencies": {
31+
"@gtm-support/vue-gtm": "1.2.3",
32+
"@quasar/extras": "1.10.10",
33+
"clone-deep": "4.0.1",
34+
"core-js": "3.12.1",
35+
"dayjs": "1.10.7",
36+
"dotenv": "16.0.0",
37+
"electron-log": "4.4.8",
38+
"electron-store": "8.1.0",
39+
"electron-window-state": "5.0.3",
40+
"encoding-japanese": "1.0.30",
41+
"glob": "8.0.3",
42+
"immer": "9.0.2",
43+
"markdown-it": "12.0.4",
44+
"move-file": "3.0.0",
45+
"multistream": "4.1.0",
46+
"quasar": "2.11.3",
47+
"semver": "7.3.5",
48+
"shlex": "2.1.2",
49+
"source-map-support": "0.5.19",
50+
"systeminformation": "5.8.0",
51+
"tree-kill": "1.2.2",
52+
"unzipper": "github:ZJONSSON/node-unzipper#341f258",
53+
"uuid": "9.0.0",
54+
"vue": "3.2.45",
55+
"vue-router": "4.0.8",
56+
"vuedraggable": "4.1.0",
57+
"vuex": "4.0.2",
58+
"zod": "3.20.2",
59+
"zod-to-json-schema": "3.20.1"
60+
},
61+
"devDependencies": {
62+
"@openapitools/openapi-generator-cli": "2.3.3",
63+
"@playwright/test": "1.23.3",
64+
"@types/chai": "4.2.18",
65+
"@types/clone-deep": "4.0.1",
66+
"@types/electron-devtools-installer": "2.2.2",
67+
"@types/encoding-japanese": "1.0.18",
68+
"@types/glob": "8.0.0",
69+
"@types/markdown-it": "12.2.0",
70+
"@types/mocha": "5.2.7",
71+
"@types/mousetrap": "1.6.8",
72+
"@types/multistream": "4.1.0",
73+
"@types/semver": "7.3.9",
74+
"@types/unzipper": "0.10.5",
75+
"@types/uuid": "8.3.4",
76+
"@typescript-eslint/eslint-plugin": "5.38.1",
77+
"@typescript-eslint/parser": "5.38.1",
78+
"@vue/cli-plugin-babel": "4.5.13",
79+
"@vue/cli-plugin-eslint": "5.0.8",
80+
"@vue/cli-plugin-router": "4.5.13",
81+
"@vue/cli-plugin-typescript": "4.5.19",
82+
"@vue/cli-plugin-unit-mocha": "4.5.13",
83+
"@vue/cli-plugin-vuex": "4.5.13",
84+
"@vue/cli-service": "4.5.13",
85+
"@vue/compiler-sfc": "3.2.45",
86+
"@vue/eslint-config-prettier": "7.0.0",
87+
"@vue/eslint-config-typescript": "11.0.2",
88+
"@vue/test-utils": "2.0.0-rc.6",
89+
"chai": "4.3.4",
90+
"chai-as-promised": "7.1.1",
91+
"electron": "20.3.3",
92+
"electron-devtools-installer": "3.2.0",
93+
"eslint": "8.24.0",
94+
"eslint-config-prettier": "8.5.0",
95+
"eslint-plugin-prettier": "3.4.0",
96+
"eslint-plugin-vue": "9.5.1",
97+
"license-checker": "25.0.1",
98+
"markdownlint": "0.23.1",
99+
"markdownlint-cli": "0.28.1",
100+
"mousetrap": "1.6.5",
101+
"prettier": "2.3.0",
102+
"sass": "1.32.13",
103+
"sass-loader": "8.0.2",
104+
"tmp": "0.2.1",
105+
"typescript": "4.8.4",
106+
"vue-cli-plugin-electron-builder": "3.0.0-alpha.4",
107+
"vue-tsc": "0.40.13",
108+
"yargs": "17.2.1"
109+
}
110+
}

public/contact.md

+2
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,5 @@
1+
# お問い合わせ
2+
13
## ご感想・ご要望
24

35
ぜひ Twitter にてハッシュタグ `#VOICEVOX` を付けてツイートしてください。開発の励みになります。

0 commit comments

Comments
 (0)