<commit_before>---
layout: caymanyomi
category: ai
docid: ctusin
title: やまびこ通信用Chatty原稿の形式
author: 水野光子
date: 2019-08-06T11:32:32Z
iro: cb5300
gra: feffcf
math: false
---

# やまびこ通信用Chatty原稿の形式
{:.no_toc}

やまびこ通信の原稿を作る際には、通常のChatty原稿の注意事項に加えて、自動的にウェブ用の形式に変換するための記号にも留意する必要がある。

## 目次
{:.no_toc}

* TOC
{:toc}


## やまびこ通信のワード原稿からChatty原稿を作成する作業の流れ

1. 機種依存文字を汎用文字に置き換え、全角スペースや全角数字を半角に直し、行頭のスペースやタブを削除し、2つ以上のスペースの連続を1つのスペースに置き換える。
2. 前号のChatty原稿を開き、新号用に名前を変えて保存する。
3. そのファイルで一時的に新規インデックス（セクション）を追加し、上記1の作業が済んだ原稿の文字部分をコピーし、新規セクション内にペーストする。
4. 新規セクション内の新号の文章を1節程度ずつ切り取り、前号のセクション内に貼り付け、前号の形式と見比べながら同じ形になるように直し、直し終わったら前号の文章を削除する。
5. 新号の文章の形式を全部修正し終わったら、一時的な新規インデックスを削除する。
6. 自動読み上げを聞きながら、読み上げの修正をする。
7. DAISY2.02（マルチメディア）としてエクスポートする。
8. エクスポートで作成されたフォルダ内のmaster.smilファイルをテキストエディタで開き、読み上げ時間を確認する。
9. Chatty原稿の冒頭にある読み上げ時間を正しい数値に直して原稿を保存し、そのimlxファイルをウェブ化担当者に渡す。

以上のうち、1の作業を自動化するプログラムは作ってあるが、それを使うにはlinuxが必要。

2の作業で、新号の編集のために前号のデータを使うことは重要。よく使う単語の読みが全て登録されているので、単語登録の手間が省け、各号の品質の安定性が保たれる。

## やまびこ通信用の特別な注意事項

![原稿サンプル、1/5](media/ctusin/tusin1.png){: .naka}

- 通常のChatty原稿では、冒頭にタイトルが入るが、ウェブ用の特別措置としてロングポーズ5個で始まる。これは、ウェブページをスクリーンリーダー付きの機器で開いた場合に、ページの発する音声がスクリーンリーダーの音声と重ならないようにするため。

- ウェブ用では、文字で書かずに音声だけで説明を入れる部分がある。その部分の文字がウェブページでは表示されないように変換するための記号として、  
```
ケス...スケ
```  
で挟む。記号である`ケス`と`スケ`自体は読み上げられないように、無音化`Ctrl 0`する。

- カット画像（挿絵）を指定された位置に入れるため、その位置に  
```
（カット1）
（カット2）
（カット3）
...
```  
という記号を入れる。数字は挿絵の順番。  
括弧は全角、数字は半角で書く。  
この記号自体が読み上げられないように、無音化`Ctrl 0`する。

- リストの各項目の最後に、ロングポーズ`Ctrl Shift L`を入れる。最後に句点や閉じ括弧がある場合は、その直前に入れる。

- 各節の最後にはロングポーズ`Ctrl Shift L`を3個以上入れる。俳句の節の最後は4個以上。最後に句点や閉じ括弧がある場合は、その直前に入れる。

- 文章の内容に応じて、以下の4種類の区切りを使い分ける。
   - ハイライト分割`Ctrl Shift /`：フレーズ区切り
   - ロングポーズ`Ctrl Shift L`：大きめの意味のまとまり
   - ショートポーズ`Ctrl Shift S`：小さめの意味のまとまり
   - 半角スペース：単語の区切り

- フレーズを切りたくない場所で読み上げフレーズが切れてしまうところには、ハイライト結合`Ctrl Shift +`を入れる。

- 各節の見出しの冒頭には半角のナンバーサイン`#`2個と半角スペース1個を付け、  
```
## 見出し
```  
という形にする。  
小見出しはナンバーサイン3個`### `、小小見出しはナンバーサイン4個`#### `という形で、ナンバーサイン`#`の数を増やす。

![原稿サンプル、2/5](media/ctusin/tusin2.png){: .naka}

- 対面音訳の節は、表形式で表示しているので、それ用の記号が付いている。新しい号を作成するときには、前の号のデータを使って、数字だけを書き換える。

- 俳句は同じものを2回読むことになっているので、Chatty原稿では同じものを2回書く。また、他の節の文章よりもポーズを長めに付ける。

- ルビは本来`Ctrl Shift ↑`で付けることができるが、やまびこ通信用原稿では、ワード原稿から取り込んで作業する効率上の理由で、以下の形でルビを記入することにしている。  
全角縦線`｜`と半角スペースと括弧` () `を使って、以下の形式で書く。  
```
これは｜漢字 (かんじ) です。
```  
全角縦線`｜`は、ルビが付く部分の開始をあらわし、半角スペースと括弧` () `の中身がルビ自体をあらわす。ルビ自体を読み上げないように、半角スペースと括弧` () `とルビ自体を無音化`Ctrl 0`する。  
フレーズ冒頭に限り、全角縦線`｜`を省略しても良い。

![原稿サンプル、3/5](media/ctusin/tusin3.png){: .naka}

- メニュー＞書式(O)＞HTMLタグ入力モード、またはそれに該当するボタンをオンにしてから、以下の形式を入力すると、読み上げも表示もされない連絡用のコメントを記入できる。  
```
<!--ここにコメントを書ける。-->
```

![原稿サンプル、4/5](media/ctusin/tusin4.png){: .naka}

- Let's Try! のウェブページ上の見栄えを整えるために、記号が付いている。  
新しい号を作成するときには、前の号のデータを使って、問題だけを書き換える。  
記号や問題を読み上げないように、無音化`Ctrl 0`する。

![原稿サンプル、5/5](media/ctusin/tusin5.png){: .naka}

- 「定例会」の部分は毎号同じなので、前号のデータをそのまま使い、いじらない。終わりアナウンスの数字だけを変更する。

## Chatty原稿作成の一般的な注意事項

以下のことは、やまびこ通信の場合に限らず、Chattyを扱う際にはいつでも注意するべきである。

### 音声設定

メニュー＞設定＞音声設定＞ハイライト（日本語）で、フレーズを区切る記号を選択できる。

![音声設定画面](media/ctusin/tojikakko.png){: .naka}

デフォルトでは「閉じ括弧で分割」がチェックされていない。閉じ括弧でフレーズを区切ることが多い文書では、これをチェックすると作業が楽になる。

これをチェックしている場合、閉じ括弧でフレーズを区切りたくない所では、閉じ括弧自体を無音化`Ctrl 0`すれば、フレーズが切れないようになる。

### スペース、タブ、改行をむやみに入れない。機種依存文字を使わない。

スペース、タブ、改行は読み上げ方に影響するので、文章の区切りとして適切な位置以外では使わない。

さらに、マルチメディアデイジーなどの場合、文書のレイアウトは、タグと呼ばれる記号列によって、どういう機械で表示しても全体の整合性が保たれるように管理されるので、「文字」の一種であるスペース、タブ、改行などを、編集画面での見栄えを良くするために使うことは許されない。

また、どういう機械でも正しく表示できるように、[機種依存文字](https://mect-japan.com/2017/login/guide/izon.html)の使用は避ける。

どういう機械で表示しても、数字の列の途中で折返しが起こりにくいように、全角数字を使わずに半角数字を使うほうが良い。


#### 例1
{:.no_toc}

![余計な改行](media/ctusin/kaigyo.png){: .naka}

改行は読み上げに影響するので、文の途中で改行してはいけない。

#### 例2
{:.no_toc}

![余計なスペース](media/ctusin/space_number.png){: .naka}

機種依存文字の一つであるナンバーという記号を、`No. `のような一般的な文字列に置き換える。

半角数字と全角数字の混用は見栄えが悪くなるので気を付ける。

スペースをレイアウト目的で使うことを避ける。

### 単語登録する単語として、意味のまとまりとなる範囲を選択する。

単語の一部分だけを単語登録`Ctrl J`しない。

#### 例1
{:.no_toc}

![単語登録画面、国際視覚障がい者](media/ctusin/tango_kokusaisikaku.png){: .naka}

「国際視覚障がい者スポーツ連盟」の「国際」は「視覚障がい者」に係るのではなく、「連盟」の方に係るので、「国際視覚障がい者」という単語ではない。この形で登録するのは不適切である。

以下のように、「国際視覚障がい者スポーツ連盟」を単語として登録するのは適切である。

![単語登録画面、国際視覚障がい者スポーツ連盟](media/ctusin/tango_kokusaisikaku2.png){: .naka}

#### 例2
{:.no_toc}

![単語登録画面、夏体験](media/ctusin/tango_natutaiken.png){: .naka}
<commit_msg>ctusin<commit_after>---
layout: caymanyomi
category: ai
docid: ctusin
title: やまびこ通信用Chatty原稿の形式
author: 水野光子
date: 2019-08-06T11:32:32Z
iro: cb5300
gra: feffcf
math: false
---

# やまびこ通信用Chatty原稿の形式
{:.no_toc}

やまびこ通信の原稿を作る際には、通常のChatty原稿の注意事項に加えて、自動的にウェブ用の形式に変換するための記号にも留意する必要がある。

## 目次
{:.no_toc}

* TOC
{:toc}


## やまびこ通信のワード原稿からChatty原稿を作成する作業の流れ

1. 機種依存文字を汎用文字に置き換え、全角スペースや全角数字を半角に直し、行頭のスペースやタブを削除し、2つ以上のスペースの連続を1つのスペースに置き換える。
2. 前号のChatty原稿を開き、新号用に名前を変えて保存する。
3. そのファイルで一時的に新規インデックス（セクション）を追加し、上記1の作業が済んだ原稿の文字部分をコピーし、新規セクション内にペーストする。
4. 新規セクション内の新号の文章を1節程度ずつ切り取り、前号のセクション内に貼り付け、前号の形式と見比べながら同じ形になるように直し、直し終わったら前号の文章を削除する。
5. 新号の文章の形式を全部修正し終わったら、一時的な新規インデックスを削除する。
6. 自動読み上げを聞きながら、読み上げの修正をする。
7. DAISY2.02（マルチメディア）としてエクスポートする。
8. エクスポートで作成されたフォルダ内のmaster.smilファイルをテキストエディタで開き、読み上げ時間を確認する。
9. Chatty原稿の冒頭にある読み上げ時間を正しい数値に直して原稿を保存し、そのimlxファイルをウェブ化担当者に渡す。

以上のうち、1の作業を自動化するプログラムは作ってあるが、それを使うにはlinuxが必要。

2の作業で、新号の編集のために前号のデータを使うことは重要。よく使う単語の読みが全て登録されているので、単語登録の手間が省け、各号の品質の安定性が保たれる。

## やまびこ通信用の特別な注意事項

![原稿サンプル、1/5](media/ctusin/tusin1.png){: .naka}

- 通常のChatty原稿では、冒頭にタイトルが入るが、ウェブ用の特別措置としてロングポーズ5個で始まる。これは、ウェブページをスクリーンリーダー付きの機器で開いた場合に、ページの発する音声がスクリーンリーダーの音声と重ならないようにするため。

- ウェブ用では、文字で書かずに音声だけで説明を入れる部分がある。その部分の文字がウェブページでは表示されないように変換するための記号として、  
```
ケス...スケ
```  
で挟む。記号である`ケス`と`スケ`自体は読み上げられないように、無音化`Ctrl 0`する。

- カット画像（挿絵）を指定された位置に入れるため、その位置に  
```
（カット1）
（カット2）
（カット3）
...
```  
という記号を入れる。数字は挿絵の順番。  
括弧は全角、数字は半角で書く。  
この記号自体が読み上げられないように、無音化`Ctrl 0`する。

- リストの各項目の最後に、ロングポーズ`Ctrl Shift L`を入れる。最後に句点や閉じ括弧がある場合は、その直前に入れる。

- 各節の最後にはロングポーズ`Ctrl Shift L`を3個以上入れる。俳句の節の最後は4個以上。最後に句点や閉じ括弧がある場合は、その直前に入れる。

- 文章の内容に応じて、以下の4種類の区切りを使い分ける。
   - ハイライト分割`Ctrl Shift /`：フレーズの区切り
   - ロングポーズ`Ctrl Shift L`：大きめの意味のまとまりの区切り
   - ショートポーズ`Ctrl Shift S`：小さめの意味のまとまりの区切り
   - 半角スペース：単語の区切り

- フレーズを切りたくない場所で読み上げフレーズが切れてしまうところには、ハイライト結合`Ctrl Shift +`を入れる。

- 各節の見出しの冒頭には半角のナンバーサイン`#`2個と半角スペース1個を付け、  
```
## 見出し
```  
という形にする。  
小見出しはナンバーサイン3個`### `、小小見出しはナンバーサイン4個`#### `という形で、ナンバーサイン`#`の数を増やす。

![原稿サンプル、2/5](media/ctusin/tusin2.png){: .naka}

- 対面音訳の節は、表形式で表示しているので、それ用の記号が付いている。新しい号を作成するときには、前の号のデータを使って、数字だけを書き換える。

- 俳句は同じものを2回読むことになっているので、Chatty原稿では同じものを2回書く。また、他の節の文章よりもポーズを長めに付ける。

- ルビは本来`Ctrl Shift ↑`で付けることができるが、やまびこ通信用原稿では、ワード原稿から取り込んで作業する効率上の理由で、以下の形でルビを記入することにしている。  
全角縦線`｜`と半角スペースと半角括弧` () `を使って、以下の形式で書く。  
```
これは｜漢字 (かんじ) です。
```  
全角縦線`｜`は、ルビが付く部分の開始をあらわし、半角スペースと半角括弧` () `の中身がルビ自体をあらわす。ルビ自体を読み上げないように、半角スペースと半角括弧` () `とルビ自体を無音化`Ctrl 0`する。  
フレーズ冒頭に限り、全角縦線`｜`を省略しても良い。

![原稿サンプル、3/5](media/ctusin/tusin3.png){: .naka}

- メニュー＞書式(O)＞HTMLタグ入力モード、またはそれに該当するボタンをオンにしてから、以下の形式を入力すると、読み上げも表示もされない連絡用のコメントを記入できる。  
```
<!--ここにコメントを書ける。-->
```

![原稿サンプル、4/5](media/ctusin/tusin4.png){: .naka}

- Let's Try! のウェブページ上の見栄えを整えるために、記号が付いている。  
新しい号を作成するときには、前の号のデータを使って、問題だけを書き換える。  
記号や問題を読み上げないように、無音化`Ctrl 0`する。

![原稿サンプル、5/5](media/ctusin/tusin5.png){: .naka}

- 「定例会」の部分は毎号同じなので、前号のデータをそのまま使い、いじらない。終わりアナウンスの数字だけを変更する。

## Chatty原稿作成の一般的な注意事項

以下のことは、やまびこ通信の場合に限らず、Chattyを扱う際にはいつでも注意するべきである。

### 音声設定

メニュー＞設定＞音声設定＞ハイライト（日本語）で、フレーズを区切る記号を選択できる。

![音声設定画面](media/ctusin/tojikakko.png){: .naka}

デフォルトでは「閉じ括弧で分割」がチェックされていない。閉じ括弧でフレーズを区切ることが多い文書では、これをチェックすると作業が楽になる。

これをチェックしている場合、閉じ括弧でフレーズを区切りたくない所では、閉じ括弧自体を無音化`Ctrl 0`すれば、フレーズが切れないようになる。

### 使用する文字に関する注意

#### スペース、タブ、改行をむやみに入れない。

スペース、タブ、改行は読み上げ方に影響するので、文章の区切りとして適切な位置以外で使ってはいけない。これらは「見えない文字」であって、レイアウトを整える機能ではない。

また一般に、デジタル文書の特徴として、表示に使われる機械の性質が一律ではないため、文書のレイアウトは、タグと呼ばれる記号列によって、どういう機械で表示しても全体の整合性が保たれるように管理される。そのため、「文字」の一種であるスペース、タブ、改行などを、編集画面での見栄えを良くするために使うことは許されない。

#### アルファベットと数字は半角で。

どういう機械で表示しても、アルファベットや数字の列の途中で折返しが起こりにくいように、全角英数字を使わずに半角英数字を使うほうが良い。

#### 機種依存文字

ChattyからエクスポートするデータはデフォルトでUTF-8エンコーディングになる。この設定を変更していなければ、[機種依存文字](https://mect-japan.com/2017/login/guide/izon.html)であっても、意図したものと異なる文字として表示される心配はない。

しかし、利用者が表示に使うフォントによっては、読みにくかったり表示できなかったりする可能性がある。そのため、機種依存文字の使用はできるだけ避けることにしている。

ただし、マルチメディアデイジー作製の場合で、原本に忠実である必要がある場合には、機種依存文字であっても使わざるを得ない。

いずれにしても、エクスポートするときにShiftJISではなくUTF-8に設定されていることを確認するように習慣づけると良い。

#### 例1
{:.no_toc}

![余計な改行](media/ctusin/kaigyo.png){: .naka}

改行は読み上げに影響するので、文の途中で改行してはいけない。

#### 例2
{:.no_toc}

![余計なスペース](media/ctusin/space_number.png){: .naka}

機種依存文字の一つであるナンバーという記号を、`No. `のような一般的な文字列に置き換える。

半角英数字と全角英数字の混用は見栄えが悪くなるので気を付ける。

スペースをレイアウト目的で使うことを避ける。

### 単語登録する単語として、意味のまとまりとなる範囲を選択する。

単語の一部分だけを単語登録`Ctrl J`しない。

#### 例1
{:.no_toc}

![単語登録画面、国際視覚障がい者](media/ctusin/tango_kokusaisikaku.png){: .naka}

「国際視覚障がい者スポーツ連盟」の「国際」は「視覚障がい者」に係るのではなく、「連盟」の方に係るので、「国際視覚障がい者」という単語ではない。この形で登録するのは不適切である。

以下のように、「国際視覚障がい者スポーツ連盟」を単語として登録するのは適切である。

![単語登録画面、国際視覚障がい者スポーツ連盟](media/ctusin/tango_kokusaisikaku2.png){: .naka}

#### 例2
{:.no_toc}

![単語登録画面、夏体験](media/ctusin/tango_natutaiken.png){: .naka}

{'fraction_non_alphanumeric': 0.1362325271799423, 'fraction_numerical': 0.017528289327712446, 'mean_word_length': 9.373993095512082, 'pattern_counts': {'":': 0, '<': 5, '<?xml version=': 0, '>': 5, 'https://': 2, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '2919263', 'n_tokens_mistral': 8226, 'n_tokens_neox': 8157, 'n_words': 332}