wikifying-ja
wikifying(ウィキ化)とは、自身の「利用者(User:)」ページを起点として、IndieWeb Wiki上に情報やアイデアを記録する習慣のことです。例:あのFAQやコンセプト、jargon(専門用語)、あるいはetherpadの内容を「ウィキ化」する必要がある、といった使い方をします。
このページのステップ・バイ・ステップの指示に従って、以下の操作を行ってください:
- ステップ 1:自分のWikiページを作成する。
- ステップ 2:自分のWikiページを編集する。
- ステップ 3:(任意)chat-namesに自分を追加する。その際、アイコン(アバター)も併記するのが望ましいです。
- ステップ 4:(任意)個人用Wikiテンプレートを設定する。これにより、Wiki内であなたのチャット名がリンクされた際、その横に写真が表示されるようになります。
その後、Wikiへの貢献を始めてください。
なぜIndieWeb Wikiに参加するのか
私たちはコミュニティとして、メールの使用を避け、代わりにリアルタイムのチャットを利用し、重要なポイントをWikiに文書化しています。これにより、時間の経過とともに情報の検索や蓄積、ドキュメント化が容易になります。
Wikiに参加することは、コミュニティの成長を助けるだけでなく、あなた自身の歩みの記録にもなります。これは、あなたと同じように「自分が所有する場所で自分のデータを管理したい」と願う次の誰かの助けとなります。
Wikiに参加する各人は、時間の経過とともに更新・構築していく利用者ページを持ちます。自分のストーリーを伝えるために、ページを自由に形作ることができます。始めるにあたっては、以下の例を参考にアイデアを探してみてください。
IndieWebの例
Tantek Çelik
Aaron PareckiDavid Shanske
gRegor Morrill
Chris Aldrich
Greg McVerry
Jamie Tanna
Kimberly Hirsh
V.H. Belvadi
Khürt Williams
Dr. Matt Lee
Rickard Lindberg- Morgan
IndieWeb Wikiへの参加方法
ユーザー名とパスワードを選択する他のサイトとは異なり、このWikiへのログインにはご自身のドメイン名のみが必要です。認証には indielogin.com を使用します。まだ済んでいない場合は、認証してログインできるように、ご自身のドメインでWebサインインの設定を行ってください。
Webサインインができるようになると、Wikiへのログインだけでなく、イベントへのログインや欠席確認(RSVP)、さらには投稿アプリやソーシャルリーダーといった他の多くのIndieWeb構成要素も利用できるようになります。
ステップ 1:利用者ページを作成する
ログイン後、自分の利用者ページにアクセスしてください。次に「作成(Create)」をクリックします。ページにプロフィールを追加するために、2つのテンプレートから選択できます。
後日ページを編集したい場合は、自分の利用者ページに移動するか、右上の自分のドメイン名をクリックしてください。そこから「編集(Edit)」をクリックします。
最小限のプロフィール
IndieWebコミュニティでは、オンラインで個人を特定するためにh-cardを使用します。これはあなたのウェブサイトの名刺のようなものです。
最も小さいh-cardには、あなたの名前とウェブサイトへのリンクが含まれます。
<span class="h-card">[https://example.com/ あなたの名前]</span>
情報ボックス・プロフィール
例えば
Aaron Parecki のようなプロフィールボックスを表示したい場合は、専用のテンプレートを用意しています。
Infobox person に移動し、空のテンプレートをコピーしてください。その後、自分のWiki利用者ページに戻り、「編集(Edit)」(ページがない場合は「作成(Create)」)を選択します。テンプレートをページに貼り付け、表示したい関連データを入力・置換してください。ページ下部の「変更を表示(Show Changes)」ボタンを使うと、保存前に見栄えを確認できます。納得がいったら変更を保存してください。後からいつでも変更できることを忘れないでください。
個別の利用者ページ作成を避ける
Wikiにサインインする際、あなたのドメインがログインIDとなるため、Wikiの「利用者(User:)」ページもあなたのドメイン名になります。これにより、ログイン用のプロフィールページが提供され、Wikiへの貢献がそこにリンクされます。自分の名前やニックネームなどを使った、ドメイン名とは別の「利用者:」ページを作成しないでください。
あなた(または他の誰か)があなたの「利用者:」ページを訪れると、サイドバー(テーマにより左または右)に「利用者の投稿記録(User contributions)」へのリンクが表示されます。これをクリックすることで、その人の最近のWikiへの貢献を確認できます。
別名で作られた「利用者:」ページは「偽物」であり、ログイン情報が紐付いていないため、あなたや他の人が投稿記録を確認するためのリンクが表示されません。
もし(誤って、あるいは良かれと思って)別の「利用者:」ページを作成してしまった場合は、そのページを削除するか、ログインドメインである実際の「利用者:」ページへリダイレクトさせてください。
もし誤って実際の「利用者:」ページを別のページへリダイレクトさせてしまった場合は、別のページの内容を実際のページへ「移動」し、リダイレクトを上書きする必要があります。
誰かが上記のような間違いをしているのを見かけたら、チャットで連絡を取り、このセクションへのリンクを添えて、なぜ修正が必要か、どうすれば直せるかをアドバイスしてあげてください。
もしその人がチャットにいなかったり返信がなかったりする場合は、適宜修正を行っても構いません。その際は、編集内容の要約にこのセクションへのリンクを含む親切なコメントを残し、不明点があればチャットへの参加を促すようにしてください。
ステップ 2:自分のWikiページを編集する
Wikiページは好きなように形作ることができます。多くのコミュニティメンバーが含めている一般的な要素をいくつか紹介します。
自分の「Itches(うずき・やりたいこと)」を書き出す
次に、「Itches」セクションを追加して、自分のサイトで取り組みたいこと、個人的なオンライン上でのデジタルプレゼンス、および個人的なデジタルデバイスの使用全般(オフライン時も含む)について記録しましょう。例:
== Itches(やりたいこと) == * 自分のサイトにもっと詳細な [[h-card]] を追加する * 投稿用の [https://zenn.dev/fizumi/scraps/7a7658efe699a4] を考える * [[notes|ノート]] を [[permalinks|パーマリンク]] で手動投稿し始める * indiewebify.me で自分のサイトをチェックしてみる * 自分のサイトに追加するアイデアを探すために [[IndieMark]] をチェックする
やりたいこと(Itches)がたくさん溜まってきたら、優先順位をつけたくなるかもしれません。特に現在取り組んでいるものを区別するために、「Working On(取り組み中)」セクションを作ってみましょう:
== Working On(取り組み中) == * 自分のサイトで次に取り組む予定のこと * その次に自分のサイトで動かそうとしていること * ... など
フォーカス(重点を置くべきこと)
これはIndieWebの活動であり、あなたのIndieWeb利用者ページに関するものです。そのため、ページの内容は常に次の問いに答えるものであるべきです:
- 自分の個人サイトで、次に実現させたいことは何か?
つまり、例えば以下のような内容は、ここではなく自分のサイトなどで進めるのが適切です:
- 個人的なToDoリスト(個人サイトに関係のない雑事) — 利用者ページはあくまで個人サイトに関する作業のための場所です。
- 他人に作業を依頼すること。注:IndieWeb特有の悩み(Itches)やプロジェクトへの協力依頼はOKですが、特定の個人ではなく全員に向けて発信してください。ここは「あなたが取り組みたいこと」を記す場所であり、他人に仕事を頼む場所ではありません。
- 「サイロ(既存のSNS等)」に何かをさせようとすること(一般論または特定の目的を問わず) — 代わりに、個々のサイロの問題は特定のサイロ用Wikiページに記録し、そこで追跡してください。あなたのItchesは、サイロではなく自分の個人サイトに関するものであるべきです。
追加のテンプレート
利用者ページに追加できる、定義済みのWikiテンプレートです:
- 情報ボックス用:Template:Infobox_person
- Twitter(現X)用:Template:twitter-link
- Facebook用:Template:facebook-link
- Mastodon用:Template:mastodon-link
ステップ 3:チャット名を追加する
任意で、chat-names(チャット名リスト)に自分を追加してください。これにより、チャットログ内のあなたの名前の横に写真が表示され、名前から自分のウェブサイトへリンクされるようになります。また、フレンドリーなチャットボット Loqi が、「[ユーザー名]って誰?」という質問に対して、あなたのWiki利用者ページの情報を使って答えられるようになります。
チャット名を追加するには、chat-namesにアクセスし、用意されているテンプレートを使用してください。
ステップ 4:スパークライン(ミニアイコン)を追加する
IndieWeb Wikiでは「スパークライン」を使用できます。これは、あなたの写真と利用者ページへのリンクが含まれた小さなアバターです。これにより、任意のページに {{あなたのチャット名}} のようなテキストを記述するだけで、アバター付きのあなたの名前(リンク付き)を表示できるようになります。
- 設定方法については、チュートリアル:個人用Wikiテンプレートの設定を参照してください。
なぜIndieWeb Wikiに貢献するのか
一般的なトピックであれ、特定の主題、ノート、ドキュメントであれ、「ウィキ化」することは、IndieWebコミュニティの検索・発見可能な共有資産(コモンズ)を育てることにつながります。
それはIndieWebに関連するもの、あるいはIndieWeb特有のものですか? それならぜひWikiに追加してください。
確信が持てない場合や、一般的なトピックを文書化したい場合は、まずWikipedia(への加筆)から始めるか、チャットで相談してみてください。
追加すべきもの(すべきでないもの)の例については以下を参照してください:
IndieWeb Wikiへの貢献方法
改善が必要なページを見つける
Wikiの改善を手伝いたい場合は、古いページを探して、整理や改善を行うことを検討してください。以下のセクションでは、誤字の修正、IndieWebとの関連性の確認、引用の追加、あるいはページの削除といった改善方法を説明します。
改善が必要そうなページを見つけるためのアイデアをいくつか挙げます:
- this-week-in-the-indieweb(ニュースレター)の「Top New Wiki Pages(注目の新規ページ)」および「Top Edited Wiki Pages(注目の編集ページ)」セクション
- 編集回数の少ないページ — これらはチャットで定義されただけで、内容の拡充が必要な可能性が高いページです(リスト内の「リダイレクトページ」は無視して構いません)。
- 短いページ — テキストがほとんどないページです。リダイレクトが正しく作成されていない場合や、チャットで定義されたまま放置されている場合があります。
- 最も古いページ — 最終編集日からの経過時間が長い順のリストです。情報が古くなっていたり、数年前の古い基準で作成されていたりする可能性があります。
- 孤立したページ — 他のどのページからもリンクされていないページです。そのページ自体の内容が充実している場合は、関連するページからリンクを貼ることを検討してください。
段階的なウィキ化(Incremental Wikifying)
少しずつ進められる「ウィキ化」の作業はたくさんあります。
- 誤字の修正
- 用語の定義を拡張(または簡略化)して、IndieWebとの関連性を含める
- 技術中心(配管的)な定義をユーザー中心の定義に書き換え、技術的な詳細は後の文章や別のページに移動する(「開発者向け」などの記述を添えてリンクする)
- IndieWebの事例(IndieWeb Examples)を追加する — 自分のサイトでサポートしている技術やプロジェクトのページを見つけたら、そのページの「IndieWeb Examples」に自分を追加してください。
- 課題や質問(FAQ用)を追加する
- チャットでのQ&Aをまとめ、適切なWikiページに追加する
- 内容が増えてきたページの構成を、ページの拡張ガイドに従ってセクション分けして整理する
以下も参照してください:
- expand a page:段階的なウィキ化に関する多くの具体的な提案があります。
- to-do:段階的な改善が必要な特定のページの一覧です。
一般的に、小さく段階的な編集は「差分(diff)」が分かりやすくなり、コミュニティによる確認や修正が容易になります。
引用の追加
Loqi(あるいは誰でも)がチャットでIndieWebに関連するリンクを共有した際は、それらを引用や事例としてWikiに追加してください。特に写真の場合は、イベントページに追加をお願いします。
引用の書式
引用をテキスト形式で追加する方法です。最小限のものから、より詳細なものへと段階的に改善できます。
- リンクのみ
- 真面目な話、リンクを貼るだけでも十分助かります!
- YYYY-MM-DD リンク
- 記事の公開日を追加すると、時系列の文脈が分かりやすくなり、非常に役立ちます。
- YYYY-MM-DD [リンク 記事タイトル]
- さらに、記事タイトルを取得して追記すると、リンクだけよりも読みやすく、検索性も向上します。ツイートなどでタイトルがない場合は、要約した一文を使いましょう。
- YYYY-MM-DD 著者名: [リンク 記事タイトル]
- 著者を加えることで、情報の信頼性や「誰が言ったか」という文脈が明確になります。
- YYYY-MM-DD {{indiewebauthor}}: [リンク 記事タイトル]
- 著者がIndieWebコミュニティの参加者である場合は、{{}} テンプレート(ショートネームやチャットのニックネーム)を使用してください。名前へのリンクやアイコンが自動的に表示されます。
(オプション)
- 引用の末尾に
blockquoteを「インライン」で追加し、リンク先から重要な一文をコピー&ペーストしてください:
YYYY-MM-DD [リンク 記事タイトル] <blockquote>重要な一文をここに!</blockquote>
これらはすべて、Wikiにテキストを貼り付けたり入力したりするだけの、非常に簡単な(ほぼプレーンテキストの)方法です。難しいコードやマークアップを学ぶ必要はありません。完璧でなくても、他の人が後で修正を助けてくれます。
Wikiページをプレーンテキストに近い状態に保つことで、他の人も編集や改善がしやすくなります。
大切なのは、まずは情報を追加するという一歩を踏み出すことです。
MediaWikiのテンプレートに慣れている場合は、以下の利用も可能です:
引用の追加場所
ページ内のどこに引用を入れればよいか分からない場合は、末尾の「See Also(関連項目)」セクションに追加してください。
- チャットから「<<」というトリックを使って、次のように行うこともできます。
wikipagename << YYYY-MM-DD [link article-name]
など。
引用内容が批判(criticism)である場合は、記事の「Criticism(批判)」セクションに追加、または移動してください。
これらはすべて段階的なステップであり、必須ではありません。どれもあなたが協力できることです。
上記の段階的なステップのひとつひとつが、ウィキの助けになります。
たとえ一箇所だけの改善であっても、非常に役立ちます!
新しいページ
新しいページを作成する「前に」、IndieWebウィキに関連するものを読んでください。
以下の場合に新しいウィキページを作成してください:
- チャットなどで議論されている新しい概念や用語。
- まずは {{stub}}(スタブ)と、IndieWebとの関連性を含めたユーザー中心の短い定義から始めてください(次のセクションを参照)。
- 何らかの形でIndieWebに直接関連している必要があります(ここはWikipediaではありません)。
- 用語に「ユーザー中心の意味」と「仕組み(実装)中心の意味」がある場合は、ウィキページの定義にはユーザー中心の意味を優先してください。
- IndieWebCampやHWCのセッション終了後のEtherpadノートのアーカイブページ。セッションノートを、より見つけやすくリンクしやすい場所にアーカイブしてください。
- 自身の個人サイトで使い始めた新しいプロジェクト。そのページの「IndieWeb Examples(IndieWebの実装例)」セクションに自分のサイトを必ず掲載してください。
もしIndieWebに特に関連がないもの(例:IndieWeb関連の議論で一度も登場しなかったもの)は、代わりにWikipediaで文書化することを検討してください(あるいはWikipediaをリファレンスや引用として利用してください)。
IndieWebとの関連性が即座に定義されていない新しいページは、削除される可能性があります。
複数の単語からなるページ名
複数の単語からなるウィキページの名前を付けるときは、WikiCase(型)やcamelCase(キャメルケース)ではなく、スペースを入れた複数の単語、または複数の単語からなる用語にはダッシュ(ハイフン)を使用してください。
定義にはIndieWebとの関連性を含める
定義には、なぜそれが具体的にIndieWebに関連するのかを含めるべきです。
例えば、前述の専門用語(jargon)の例は、IndieWebとの関連性を加えることで次のように改善できます:
- 専門用語(Jargon)とは、特定の分かりにくい単語、概念、技術(Webmentionなど)、または一般的な意味とは異なる意味での単語の再利用(feedなど)、あるいは頭字語としての再利用(POSSEなど)を指します。
また、jargonition(専門用語による定義)は避けてください。親しみやすさという点において、実務上ではsnarkinition(皮肉まじりの定義)よりもはるかに有害です。非開発者を怖がらせて遠ざけるよりは、(Hacker Newsに集まるような層を必ずしも惹きつけない、あるいは遠ざけることになったとしても)私たちは構いません。技術を自虐的に笑うユーモアは、不親切な文章で人々を疎外することよりもずっと許容されます。
意思決定を記録する
ユーザーページに自分の情報を記載し、「Itches(気になること)」や「Working On(取り組んでいること)」を段階的に記録し始めたら、作業が完了して個人サイトに公開する際に、その「主要な意思決定」をユーザーページや、プロジェクトページの「Implementation Design(実装設計)」セクションに記録してください。
例:
- Falcon#Implementation_Design - これまでにFalconで行われた主要な設計上の決定事項。
主要な設計や実装の決定を記録しておくことで、いつそれらを再検討すべきか、あるいはいつ代わりに新しい個人サイトの機能や仕組みに取り組むべきかを、より適切に判断できるようになります。
専門用語を定義する
チャットやその他のIndieWeb関連のコミュニケーションで誰かが専門用語を使ったら、遠慮なくチャンネルでこう尋ねてください:
- What is [専門用語]
これにより、Loqi(ボット)がウィキの定義を回答するか、ウィキにページを作成するためのリンクを示して定義を促します。
その後、そのリンクをクリックして定義するか、あるいは「What is」の質問に答える形で定義できます:
- [専門用語]とは、特定の分かりにくい概念、または一般的な意味とは異なる意味での単語の再利用のことです。
良い定義の書き方の詳細は、definitionを参照してください。
ツイート可能な定義
ウィキページの定義をチェックし、ツイート可能な長さに編集してください。良い定義がツイートに適した長さ(その後のページへのリンクを含む)であれば、人々がそれをツイートするという形跡があるためです。目安は257文字以内です(スペース + t.coリンク用の23文字を含む)。
コンテンツの段階的開示
すべてのページは、その主題に関する基礎知識の最良の情報源であることから始めるべきです。
幅広い層に理解可能な、専門用語のないシンプルな「ツイート可能な定義」から始め、コミュニティによって発見・発明された重要な調査結果や詳細を段階的に文書化してください。
そして、読者に利益をもたらす現実世界の理由やユースケースに応じて、必要な詳細のみを順次追加していきます。
ウィキ上のほぼすべてのページは、関連コンテンツの段階的開示(Progressive disclosure)という観点から改善の余地があります。
例えば、getting started(はじめに)はこの点で継続的に改善できますし、web hosting(ウェブホスティング)も同様です。
リダイレクトの置き換え
リダイレクト(#redirect:[[]] の行しかないページ)を編集し、実際のコンテンツに置き換える場合は、まず #indieweb-meta discuss チャンネルで実際のコンテンツに置き換える旨を伝え、その後リダイレクトを削除して新しいコンテンツでページを再作成してください。
一般的なページ構成
ウィキのほとんどのページは、シンプルな定義から始まり、以下のようなセクションを追加するという共通の構成に進化してきました。
- Why(なぜ)
- How to(方法)
- IndieWeb Examples(IndieWebの実装例)
- Brainstorming(ブレインストーミング)
- See Also(関連項目)
これらの詳細については、以下を参照してください:
- expand a page(ページを拡張する)
特殊なケースのページ
多くのページに見られる共通の構成に加えて、特殊なケースのページのクラスターや事例もいくつか存在します。
標準(規格)ページ
IndieWebウィキで開発され、W3Cで開始または正式化された標準や仕様のためのページがあり、それらのページ(およびサブページ)は仕様をサポートするために進化してきました。
これらは急速に進化していますが、以下の例を参考にしてください:
また、他所で開発された標準や、コミュニティ間で活発に協力して開発された標準のIndieWebでの活用に関するページもあります(例:各種microformatsのページ)。これらは一般的に上記の共通構成をとりますが、セットとして注目すべき特殊なパターンを持つ場合があります:
(stub) - この種の特殊なページに共通するパターンの文書化に協力してください。
歴史ページ
歴史の記録を助けるページもあります。例:
(stub) - この種の特殊なページに共通するパターンの文書化に協力してください。
世代を超えたページ
特定のIndieWeb building-blocks(構成要素)が普及するにつれ、後発のgenerations(世代)の人々にとって、コンテンツを再編成することが有益になる場合があります。場合によっては、「導入向け」コンテンツ(高レベルの解説、スクリーンショット付きの例、ツールやサービスなど)を「開発者向け」コンテンツ(プロトコル図、コードスニペット、ブレインストーミングなど)から切り離すことが役立ちます。例:
- Webmention は導入ページであり、開発者向けの詳細な内容は Webmention-developer に移動されています。
(stub) - この種の特殊なページに共通するパターンの文書化に協力してください。
全般的な提案
ウィキの編集や文章の追加に関する全般的な提案です。
段階的な編集に加えて、以下を検討してください:
- ヒント:ウィキに文章を追加する際、文の終わりや長い句の後に「セマンティック・ラインブレイク(意味的な改行)」を入れることを検討してください(https://rhodesmill.org/brandon/2012/one-sentence-per-line/ を参照)。
関連するウィキ化の記事
上記の内容は、特に「IndieWebにとって」良いウィキ化とは何かに特化したものです。
以下は、一般的な良い執筆、構成、ウィキ化に関する関連記事です:
IndieWebウィキに投稿すべきでないもの
ウィキに追加されたものや、IndieWebウィキにとって特に有用ではない、あるいは適切ではない慣習のリストが増えてきたため、独自のセクションを設けました。
まずは relevant to the IndieWeb wiki を読んでください。
Wikipediaからコピーしない
Wikipediaからテキストをコピーしたり、Wikipediaと同じことを言い換えたりしないでください。代わりに、Wikipediaのページにリンクを張ってください(「See Also」セクションなどから)。
LLMが生成したテキストをコピーしない
IndieWebウィキのテキストを書くためにChatGPTのようなツールを使用したり、その他大規模言語モデル(LLM)によって生成されたテキストをコピーしたりしないでください。
例外:正当な理由がある場合(例:問題を文書化するため)、それがLLMの出力であることを明確に示し(できれば引用元を添えて)、引用する権利がある場合に限り、引用(<blockquote> タグなどを使用)することができます。
「See Also」セクションに追加すべきでないもの
IndieWebに直接関連していないサイト、IndieWeb(個人)サイトではないサイト、あるいは少なくとも相応に確立されたニュースソースや独自のコンテンツを持つトピック特化型ブログではないサイトへのリンクを「See Also」に追加しないでください。他サイトのコンテンツをまとめただけのサイト(元のソースへリンクしてください)や、広告に囲まれたまとめサイト/ブログへのリンクは特に避けてください。そのような追加は、即座に差し戻される可能性が高いです。
見出しに追加すべきでないもの
見出し内のハイパーリンクを避ける
(サブ)見出しに直接ハイパーリンクを入れないでください。代わりに、その(サブ)見出しのセクション内のコンテンツにリンクを入れてください。
理由:慣習的に、リンクされた見出しはそのセクションへのパーマリンク(フラグメント)へのショートカットとして使われるのが一般的です。そのため、別の場所(特に別のサイト)にリンクされていると、ユーザー体験として混乱を招きます。
見出し内の句読点を避ける
見出しに句読点を入れるのは避けてください。リンク用のフラグメント(URLの末尾)が読みにくくなるためです。
見出しを作成する際は、ダッシュ、コンマ、疑問符(FAQの小見出しなど)などの句読点を取り除き、句読点を含む長い形式の文章は見出しの直後の本文に入れてください。
FAQ
これはウィキに載せるべきですか?
ウィキやMediaWikiの構文を使わなければなりませんか?
ウィキに直接コンテンツを追加したい場合は、how to edit this wiki が基本的なガイドになります。
標準的なマークアップ using standard markup を使ってウィキにコンテンツを掲載するのは素晴らしいことですが、すべての人がウィキのファンであったり、方法を知っていたり、学ぶ時間があったりするわけではないことも理解しています。(自分が行ったことを文書化するだけでも、重要かつ十分な作業です。)
- 代替案:自分のサイトにCC0ライセンスで投稿する! 別の選択肢として、まず自分が究極のコントロール権を持つ自分のサイトに投稿するというIndieWebのprinciple(原則)を実践することです。その後、「Indieweb」にウェブメンションを送るか(Superfeedr用)、チャットにリンクを投げてください。その投稿のコンテンツをCC0としてライセンスしている限り、誰かがきっとあなたに代わってウィキに追加してくれるでしょう。
- 段落には2行改行を入れて、コンテンツを追加してください! マークアップやフォーマットが完璧でなくても、適切だと思う場所に精一杯コンテンツを追加することに罪悪感を感じる必要はありません。近い将来、他の誰かがやってきて綺麗に整えてくれます。また、ウィキ化について詳しく知りたい場合は、チャットで助けを求めることをためらわないでください。
関連チャット:
- https://chat.indieweb.org/2016-05-20#t1463775866966000
- https://chat.indieweb.org/dev/2017-06-18#t1497799332968000
ウィキのどこに何かを追加すべきですか?
IndieWebに関連する記事、投稿、概念を見つけ、それをウィキに追加したい(単に「See Also」としてだけでも)と思ったとき、どこに追加すべきか迷うかもしれません。追加場所に関するヒントをいくつか挙げます:
1. 最も関連性が高い既存のページ。 2. もし複数のページ(例:privacyのような一般的な概念と、Facebookのような特定のサイロ)が思い浮かぶ場合は、両方に追加しても構いません。 3. 関連するページがいくつか思い浮かぶ場合は、そのための新しいスタブ(書きかけ)ページを作成し、それら関連ページの「See Also」セクションにそのスタブページへのリンクを追加してください。
ブレインストーミング
このページへの追加アイデア。
Wikipediaへのリダイレクト
Tantek Çelik: Wikipediaのページの要約、最初の一文、あるいは一段落と同等かそれ以下の内容しかないスタブを作成する代わりに、IndieWebウィキのそのトピックページから、[[Wikipedia:...]] プレフィックスを使用してWikipediaの対応するページへのリダイレクトを作成してください。例えば、TormentJargon というスタブページを作る代わりに、そのページに #redirect:[[Wikipedia:TormentJargon]] というリダイレクトを作成します(注:TormentJargon は実在する用語ではなく、ほとんどのjargon(専門用語)が誰かを苦しめる(torment)という事実を指しています。そのため、直接的かつ具体的なIndieWebとの関連性がない限り、ここで行き止まりのスタブを作るのではなく、Wikipediaへリダイレクトしてください)。
意見はありますか?
- +1
Pat Oyson-Matthan — ウィキ編集に便利なヒントです。 - +1
gRegor Morrill — [[Wikipedia: term]]構文を使ってリンクを作成できることに注目。 最近の例 - +1/0/-1 Add yourself here… (see this for more details)
- ...
| Organizing Links | |
|---|---|
| General Tools | web chat • online chat clients • Events Calendar • Etherpad • remote participation • Zoom |
| IndieWebCamp | Planning • Organizing • Ticketing • Pop-up Organizing • Volunteer • What to expect at camp • Sponsor • IndieWebCamp kit • session facilitating • hallway track • photography policy |
| Categories | Organizing • Events • Camp Schedules • Camp Sessions • Organizer Meetups • Demos |
| Homebrew Website Club | Regular Meetings • How to Organize • Suggested Agenda • Online Format • Virtual HWC • Upcoming HWCs |
| Contributing to the wiki | MediaWiki: how to edit this wiki • wikifying • relevant • definition • start a page • expand a page • features we use |
See Also
- start a page
- expand a page
- Wikipedia: Minor edit 変更時に「細部の編集」にチェックを入れるべきかどうかの判断に。
- creator
- commons
- Template:sparkline#How_to_make_a_small_h-card_template
- to-do
- 物議を醸す編集や配信が行われた場合に、この記事を拡張するためのヒント:https://en.wikipedia.org/wiki/Talk:Recession#ATTENTION_NEW_VISITORS_TO_THIS_PAGE
- 「<<」の使用ヒント — ページに新しい関連情報を追加するのに役立つと思われるツイートを見つけた際、そのツイートが主に他のリンク先やスクリーンショットのリソースに対する(あるいはついでに述べられた)コメントである場合は、そのリンク先を追加するか、スクリーンショット内の元のコンテンツを探してツイートの代わりに追加してください。
- ^ [schmarty] ルール
- 「See Also」への追加を、ページの核心的なコンテンツや構成に組み込むのを手伝ってください。Loqiの「<<」コマンド経由でチャットから追加されたと思われる「See Also」セクションのリスト項目を確認し、それらがページの実際の核心的なコンテンツのどこに配置されるべきかを判断してください。適切な場所が見つからない場合は、必要に応じてセクションを追加し、expand a page(ページを拡張)してください。
- 段階的な共同編集の全般的なヒント:ウィキ(または1つのページ)を編集するときは、「不完全でどう貢献すればいいか分からない」状態よりも、自分が見つけたときと同じ、あるいはそれ以上の「他の誰でもすぐに編集に参加できる」状態で残すようにしてください。そうすることで、他の人があなたの編集を引き継いでさらに反復し、ウィキ(またはそのページ)を段階的に改善し続けるためのハードルを下げることができます。
- 技術に関するページでは、上部またはその近くに次のものを配置すべきです:ユーザー中心のユーザーフロー/ストーリーのdiagram(図)、およびその技術が使用されている文脈での非常にシンプルで最小限のコード例(例:1つか2つのHTML要素内でハイライトされたmf2クラス名)。
- to-do 「実装は簡単(simple to implement)」のような、まず間違いなく簡単ではないことを些細に見せるフレーズの使用を積極的に抑制してください。そのような表現は、実装の試みや経験が「簡単」ではなかった人々に、悪い気分を抱かせる効果しかありません。
- to-do 「単に(simply)」「基本的には(basically)」「ただ~するだけ(just)」といった、提案された行動を些細なことのように見せる空虚な副詞の使用を積極的に抑制してください。また、それらの用語を使って行動を些細に扱っているページがあれば、コピーエディット(推敲)に協力してください。
- サインインは、スタートアップ企業のサイトや個人のビジネスサイトではなく、個人のサイトで行ってください(ビジネスの内容は問いません)。組織、スタートアップ、またはその他のビジネスのために作成されたユーザーページは、削除される可能性があります。
- FAQ:HTMLコメントの後でページが壊れたり空白になったりするのはなぜですか? A:最近の変更で誤って追加された可能性のある、HTMLコメントの閉じタグの一部としてのエムダッシュ(—)を探してください。MediaWikiのビジュアルエディターを使用した人が原因かもしれません。すべてのHTMLコメントタグが、特殊なダッシュ(エヌダッシュ「–」やエムダッシュ「—」)ではなく、ハイフン2つ(--)を使用していることを確認して修正してください。
- 何かのために新しいページを作成すべきかどうか迷ったときは、まず既存のページのセクションにその内容を記録することから始めてください。そのセクションが別ページにする価値があると思われるほど「十分に」成長したところで、新しいページを作成してコンテンツを移動し、元の場所には2~3文の要約と新しいページを指し示す「main」テンプレートを残してください。
- 「simply」「just」「basically」に関する以前のto-doに従って:https://tantek.com/2021/087/t3/basically-just-simply-obscure
- 「解説や指示の中で、実際の複雑さや難しさを隠すために使われる言葉は他にもありますか?
“basically(基本的には)”
“just(ただ~するだけ)”
“simply(単に)”
そのような言葉に名前はありますか?
これらはしばしば、副作用として読者に恥をかかせます(簡単でないなら、それは自分のせいだと思わせてしまう)」 @Tantek Çelik 2021年3月28日
- 「解説や指示の中で、実際の複雑さや難しさを隠すために使われる言葉は他にもありますか?
- ^ こちらも参照:https://tantek.com/2021/087/t5/downplayer-word-make-something-less-significant
- 「@yoz、良い追加案です。
“trivializer(些細に見せるもの)”(@toddbarnard のスレッドを参照)から始めて、“downplayer(軽視させるもの)”と、この適切な定義を見つけました:
“Downplayer:誰かや何かを、実際より重要でないように見せるために使われる言葉。”
— https://www.deanza.edu/faculty/ramireztono/phil04/weekfiveoverhead.pdf より
あなたの挙げた例の“common X(一般的なX)”や“standard Y(標準的なY)”も、Common LispやStandard Oilのような固有名詞であったり、実際の標準(HTMLなど)が引用されている場合を除けば、軽視させる形容詞とみなせるかもしれません」 @Tantek Çelik 2021年3月28日
- 「@yoz、良い追加案です。
- ^ このトピックに関する別の記事/サイト:誰かがあなたのドキュメントを読まなければならないなら、それは“シンプル”ではない(英語)
テクニカルライティングの中から、easy、painless、straightforward、trivial、simple、justといった言葉をスキャンしてみてください。それらを取り除くことで、あなたの文章はより明快になる可能性があります。
- Wikipediaが「信頼できない」あるいはそれ以下とみなすソースの引用は避けてください:https://en.wikipedia.org/wiki/Wikipedia:Reliable_sources/Perennial_sources#Generally_unreliable
- Internet ArchiveやYouTubeのビデオを「raw」タグを使って埋め込む方法を、例を挙げて文書化してください(例:このページのビデオの埋め込みなど:2019/state-of-the-indieweb)。
- また、ウィキに追加/拡張しても構わないもの:コミュニティメンバーが参加したIndieWebに隣接する、あるいは影響を受けたイベント(イベント用のページ)(btconfのような現在のもの、Foo CampやFoo EastのようなIndieWebCamp以前または過去のものを含む)。(本日のHWC EUでの大まかな合意)。
- ^ そのようなイベントには単一のページから始め、異なる年や事例のためにサブセクションを追加してください(リンクされた例のように)。特定のイベント事例のサブセクションが「大きくなりすぎた」場合(例:ページの他のコンテンツを圧倒する場合)は、そのイベント事例専用のページの作成を検討してください。拡張/作成の候補例:ETech(O’Reilly Emerging Technologies Conference Wikipedia:O'Reilly_Media#Discontinued_conferences)。
- ^ (続き)2004年のmicroformats紹介については
Tantek Çelik と
Kevin Marks、2003年は
Kevin Marks。BloggerCon(Wikipedia:BloggerCon)。 - ^ Webzine 2005 -
Tantek Çelik が運営を支援 https://web.archive.org/web/20250211024705/http://webzine2005.com/aboutus/ (そのイベントのウィキも参照 https://web.archive.org/web/20071224174230/http://webzine.jot.com:80/WikiHome ウェブサイト、IRCチャンネル、タグのパターンに注目。WebzineはBarCampより前に組織されましたが、開催は後でした。BarCampのサイト/IRC/タグの3点セットは、おそらくWebzineの組織運営から着想を得たものです)。