共通文が全ページに配る間違い
同じ
この記事の内容
地域ごとのページを量産するのに、共通の文をテンプレートに入れて地名だけ差し替えていました。手は省けますが、共通文に誤りが一つあると、その誤りが全ページに複製されます。どのページも文面が揃っているので、見比べてもどこが変なのか浮いてきません。最初に気づいたのは、税金の金額を書いた一文でした。
同じ一文が配る同じ間違い
「この費用は年いくら」という形の一文を、27本ある地域ページすべてで共有していました。全国どこでも金額は共通だと考えていたためです。どの費用なのかについては、ここでは割愛します。
11の自治体について公式ページの原文を開いて確かめると、6つで金額が違っていました。どれも標準税率の額に県や市の超過課税が上乗せされる形で、共通文だったため6つの自治体のページにも上乗せ前の標準の額が変更されずに載っていました。
ふつうの不具合なら、一回直せば全部に効きます。共通文の誤りは、ページ同士を見比べても差が出ないので、公式ページの金額と一件ずつ照らし合わせるまで全ページに残ったままです。共通文を減らす理由は、インデックスされるかどうかより先に、ここにあります。順位を気にする前に、まずこの金額を直しました。
| 共通文の | 中身 |
|---|---|
| 手間 | 一度 |
| 間違い | 一か |
| 見つけやすさ | 全ページが |
『全国一律』という言葉への疑い
それ以来、「全国一律」「標準」「どこでも同じ」と書いてある数字ほど、先に疑うようにしています。一律に見えるのは基本の部分だけであり、上乗せを決める条例は自治体の側にあります。今回の税もそうでした。
共通の定数から引いた数字が一つ違えば、その定数を使っているページはすべて同時に間違えてしまいます。そのため定数から数字を引いて本文に埋める前に、「これは全部の対象で本当に同じか」を一件ずつ確認することにしました。
出典が開いて読めるかの確認
出典にするページは一つずつ必ず開いて、本文が読めるかどうかまで確認しています。検索結果のタイトルやスニペットだけを信じると間違えます。実際、ある市のFAQページは検索結果にタイトルもスニペットも出ているのに、URLを開くと404でした。
スニペットに残っていた古い内容を信じていれば、現在とは違う金額を正しいかのように書くところでした。相手のページはこちらの都合に関係なく書き換わりますし、消えることもあるため、出典にする前にはそのURLをいま開いて、載せたい一文が本当にあるかを確認します。
数字の持ち場
地域ごとの値を本文にハードコードするのはやめました。手で書き写すと、どこかで古い数字が一つ紛れてしまうからです。
いまは地域ごとの値をデータファイルに持たせ、本文はテンプレートがデータファイルから生成しています。自治体ごとの金額のばらつきを述べる文も手書きをやめ、データを受け取って文を返す関数にしました。本文に数字をハードコードしないので、データを修正すれば本文の数字も一緒に変わります。下の表は、この形と直書きを比較したものです。
同じ数字を二か所に持つと、片方だけ直してもう片方が古いまま残ります。これを避けるため、値の置き場所はデータファイルの一か所だけに限定しました。ページに載せる但し書きも、掲載データから毎回組み立てる関数に変え、もとの言い切りの文言は lint_stale.mjs で禁止しているので、本文に書き戻せば lint で落ちます。地域を一つ増やすときも、データファイルに一行追加するだけで済み、本文を書き換える必要はありません。
| やり方 | 起きる |
|---|---|
| 地域ごとの | どこかで |
| データファイルから | 直す |
テンプレで区切らない修正範囲
地域ページの共通文を直して終わったと思った翌日に、同じ誤りがもう一度出てきました。
直した一文の言い回しでサイト全体を grep し直すと、テンプレートの外に同じ一文のコピーが7つ残っていました。トップ、比較ページ、計算ツールの一覧など、7つとも地域ページのテンプレートを直しただけでは届かない場所です。修正範囲を「同じテンプレートを使っているページ」で区切っていたので、テンプレートを通らずに同じ文を載せていたページが漏れていました。
それからは直すたびにその言い回しをサイト全体で検索し、テンプレートの外に残っているコピーまで数えています。文面が少し違うコピーも、直さずに放ってはおきません。
複製される逃げの一文
間違いだけでなく、逃げの一文も複製されていました。調べ切れていない項目を「正確に確認できたものだけを載せています」という断り書きで埋めていたのですが、その場しのぎで一度書いた言い訳が4ページにコピーされていました。これも共通文なので、一か所の手抜きがページの数だけ並びます。直し方は間違いのときと変わらず、逃げの一文を探し、その場所の実物を一つずつ調べて埋めました。断り書きの残るページは0になり、重複検査の違反は30件から28件に減っています。埋めてみると、「どこも共通だろう」で逃げていた項目ほど実物はばらばらでした。いまは断り書きで埋めたくなった項目があれば、実物を調べて埋めるか、項目ごと消すかのどちらかにしています。
足す文も共通になる点
直す側にも同じ罠がありました。固有の中身を足してページの独自性を上げようとしたとき、地域ごとの説明を7ページに書き足したのに、重複検査の違反は29件のまま動きませんでした。原因は、足した節の中に7ページとも共通する一般論を2文ずつ一緒に入れていたことです。固有の中身を足しても同量の共通文を一緒に足せば、固有率(本文のうちそのページにしか無い部分の割合)は動きません。共通文を使い回さないよう気をつけていたのに、書き足す側の私が新しい共通文を作ってしまっていたわけです。そこで一般論はおおもとのページに一度だけ書き、各ページからはそのリンクに変更したところ、違反は27件に減りました。いまは書き足す節についても中身がその場所だけのものかを確認し、ほかのページと共通する文がどれだけ混じっているかを公開前に自動で計測する決まりにしています。
固有の情報の増やし方
独自性を上げようとして、逆に下げたこともあります。共通文を削ったときは、地域ページ27本の固有率が平均27.1%から37.3%に上がりましたが、同じことを言い直している冗長な文を削ると、あるページは37.8%から37.5%に、別のページは38.7%から37.9%に、固有率がかえって落ちました。くどい言い回しもその場所にしか無い固有の字だったので、削ると、どのページにもある共通文の割合が上がります。それからは、くどい所は削らずに、その場所でしか言えない別の事実に差し替えるようにしました。落ちたページの片方は、その地域に入る町名を並べた文に差し替えて、38.3%に戻しました。節を書き足した7ページは、最終的にどれも固有率が5.3〜7.4ポイント上がっています。固有の割合が上がったのは、その場所の事実を足したときだけでした。削るのは、読みやすさを直すときだけにしています。
増やしても上がらない固有率
量産を、ページの数を増やす作業として進めていた時期があります。ところが同じテンプレートで生成するだけだと、増えるのは共通文の量ばかりで、1ページあたりの固有率はむしろ下がります。公式の情報をあとから足した5つの区は、固有率が+16.8〜+22.5ポイント上がりました。ほかのページは±0.1ポイントしか動いておらず、足した中身がほかのページを薄めることもありません。最初に別の区で一次情報を足したときも同じ形だったので、2回続けて同じ結果が出たことになります。10の区すべてを一次情報で埋め終えた時点で、重複検査の違反は37件から30件に減り、地域ページの平均固有率は43.0%になっていました。
お客様のサイトを量産で作るときも、最初に手を打つのはここです。共通文に書く数字は全対象で本当に同じかを一件ずつ確かめ、地域ごとの値は本文に直書きせずにデータファイルから生成して、誤りを直したら、テンプレートの外までサイト全体を検索してコピーを数えます。テンプレートに入れた一文は、正しくても誤っていても全ページに同じように載り、量産の処理は一度に全ページを出力するので、誤った一文も一度に全ページへ広がります。生成する前におおもとの一文を確かめておけば、あとで全ページを追いかけて直す作業は要りません。公開したあとで直そうとすると、テンプレートの外のコピーまで探し直すことになり、前に見つけた7つのような漏れが出たこともありました。
次に読む
AIの
ニューヨーク大学と
会員番号を
個人情報保護委員会は
記事の一覧
自社でつくって運用している仕組みの記録をまとめています。
仕事のご相談
同じ作り方で、御社の仕組みを作ります 要件を固める前に、動く実物を1本お見せするところから始めます。ソースコードと設定一式は、御社のクラウドの中に残した状態でお渡しします。