Microformats.org Wiki 2.0

(Difference between revisions)

Jump to: navigation, search
(created page)
(translated top of page and 'Summary of Changes')
Line 1: Line 1:
<!-- english: 2008-11-17T17:27:22 -->
<!-- english: 2008-11-17T17:27:22 -->
<entry-title>Microformats.org Wiki 2.0</entry-title>
<entry-title>Microformats.org Wiki 2.0</entry-title>
-
<p class="entry-summary">Microformats.org has been served by a near-default MediaWiki theme since it first went live in 2005. Over the years the kind of content published on the wiki has been established, and the editing practices of our community better understood. The ‘Wiki 2.0’ project is a medium-sized undertaking to update our wiki software to better suit the communities needs, and take the opportunity to add some visual sparkle too.</p>
+
<p class="entry-summary">Microformats.org は、2005 年に生まれた最初の時以来、ほぼデフォルトの MediaWiki テーマで運営されてきました。数年を経て、wiki で公開される記事の種類は定まり、コミュニティでの編集の慣例もよく分かってきました。‘Wiki 2.0’ プロジェクトは、コミュニティが必要としていることに対応するべく wiki ソフトをアップデートし、これを機会に見た目も良くすることにしました。</p>
__TOC__
__TOC__
-
==Summary of Changes==
+
==変更の概要==
-
* MediaWiki has been updated from version 1.4 to version 1.13.2.
+
* MediaWiki をバージョン 1.4 からバージョン 1.13.2 にアップデートしました。
-
* The visual styling of the wiki has been upgraded to a completely custom skin, based on Dan Cederholm's original microformats.org design.
+
* wiki の見た目を、Dan Cederholm による microformats.rog の最初のデザインをベースにした、完全なカスタムスキンにアップグレードしました。
-
* The search feature is now located at the top-right of the page, because having it buried further down was silly.
+
* 検索機能の場所をページの右上にしました。ページのずっと下に埋もれているのはばかばかしいことだからです。
-
* The header now links to other vital parts of the microformats site — the blog and the mailing list archives.
+
* ヘッダーを microformats サイトの他の大事な所――ブログとメーリングリストのアーカイブ――へのリンクにしました。
-
* Some new extensions have been added to the MediaWiki install
+
* いくつか拡張機能を付け加えて MediaWiki をインストールしました。
-
** HTML phrase elements are now fully supported
+
** HTML phrase 要素を全てサポートしました。
-
** Code syntax highlighting has been added
+
** コードの構文強調機能を付けました。
-
** Page titles can now be overwritten in mark-up (e.g. ‘hcard’ can become ‘hCard’, or more ambitious transformations)
+
** ページタイトルでマークアップし直したものがあります(例えば ‘hcard’ ‘hCard’ にしたり、もっと大掛かりなものもあります)。
-
* ‘Talk’ pages have been <strong>completely</strong> disabled, rather than just ‘hidden’.
+
* ‘Talk’ ページは、単に ‘hidden’ にしたのではなく、機能を<strong>完全に</strong>なくしました。
-
* All wiki pages are marked up with [[hAtom]] and [[hCalendar]]
+
* wiki の全ページを [[hAtom]] [[hcalendar-ja|hCalendar]] でマークアップしました。
-
* We will now be using MediaWiki's categories feature to better organize our content.
+
* 記事をもっと体系的にするため、MediaWiki のカテゴリー機能を使っています。
-
** Pages placed into the Specifications category gets special ‘spec-like’ styling (see [[hCard]]).
+
** Specifications(仕様)カテゴリーのページは、特別な「仕様」スタイルにしました([[hCard]] 参照)。
-
** Pages places into the Draft Specifications category get different special ‘spec-like’ styling (see [[hResume]])
+
** Draft Specifications(仕様ドラフト)カテゴリーのページは、また別の特別な「仕様」スタイルにしました([[hResume]] 参照)。
-
** Pages placed into either specification category will generate links to their respective -issues pages
+
** どちらかの仕様カテゴリーのページには、個別の -issues(~の問題)ページへのリンクを作ります。
-
* TOC — table of contents — is now properly styled in the theme. There is nolonger a need to use inline styles to align the TOC to the right
+
* TOC――table of contents(目次)――はテーマにあったスタイルにしました。もう TOC を右寄せにするのにインラインスタイルを使う必要はありません。
-
* There is now styling support for both inline issues tracking and discussions within list nesting. Previously it was hard to identify discussion documentation from proposed content, and hard to follow threads. Mark-up is now supported to style these more apporpriately
+
* インライン表示の issues tracking(問題追跡)とネスト形式の議論一覧表示をサポートしています。以前は、提示された記事から議論が書かれている所を見付け出すのも、スレッドを追いかけるのも難しいことでした。これをもっと適切に表示するマークアップをサポートしました。
-
* Your username now has a [http://gravatar.com Gravatar] displayed alongside, as in blog comments.
+
* ブログのコメントと同様、ユーザー名の横に [http://gravatar.com Gravatar] が表示されます。
-
* When editing, the ‘Save’ and ‘Preview’ buttons have been reversed to try and encourage people to preview more before posting
+
* 投稿前にもう少し我慢してプレビューを見てもらうため、編集画面の ‘Save’ ボタンと ‘Preview’ ボタンを入れ替えました。
-
==How to Use Wiki 2.0==
+
==Wiki 2.0 の使い方==
The following tries to explain how best to use the new features in Wiki 2.0.
The following tries to explain how best to use the new features in Wiki 2.0.
-
===Page Titles===
+
===ページタイトル===
Between version 1.4 and 1.13 MediaWiki fixed a bug whereby headings marked up with HTML elements were excluded from the generated Table of Contents on pages. We have since used <code>H1</code> elements to override the headings of pages whilst not offsetting the TOC numbering into 1.1, 1.2, 1.3, etc. Since that bug is fixed, this hack has been replaced with a more robust mechanism.
Between version 1.4 and 1.13 MediaWiki fixed a bug whereby headings marked up with HTML elements were excluded from the generated Table of Contents on pages. We have since used <code>H1</code> elements to override the headings of pages whilst not offsetting the TOC numbering into 1.1, 1.2, 1.3, etc. Since that bug is fixed, this hack has been replaced with a more robust mechanism.
Line 35: Line 35:
<em>Rather than use <code>H1</code> elements to title your pages, instead use the new <code>entry-title</code> element</em>. This is parsed by a MediaWiki extension and overrides the entry title as displayed on the page, whilst excluding it from the TOC. It is so named, because it corresponds to the entry-title element in the underlying hAtom that each entry is now marked up with.
<em>Rather than use <code>H1</code> elements to title your pages, instead use the new <code>entry-title</code> element</em>. This is parsed by a MediaWiki extension and overrides the entry title as displayed on the page, whilst excluding it from the TOC. It is so named, because it corresponds to the entry-title element in the underlying hAtom that each entry is now marked up with.
-
===Writing Specifications===
+
===仕様ページの書き方===
The new wiki supports special display of specification documents, different from regular pages. The pages are styled more plainly and content spans the full width of the page, akin to documentation from the W3C, WHATWG and other bodies. The sidebar is pushed down into an expanded footer, so all functionality remains.
The new wiki supports special display of specification documents, different from regular pages. The pages are styled more plainly and content spans the full width of the page, akin to documentation from the W3C, WHATWG and other bodies. The sidebar is pushed down into an expanded footer, so all functionality remains.
Line 48: Line 48:
Categories should be declared at the base of articles, please.
Categories should be declared at the base of articles, please.
-
===Discussions and Issues===
+
===議論と問題===
Within documents discussions are often represented through nested lists. They are hard to follow, and hard to differentiate from the actual content of the document. You can now mark them up and have them presented more appropriately, and hopefully more clearly.
Within documents discussions are often represented through nested lists. They are hard to follow, and hard to differentiate from the actual content of the document. You can now mark them up and have them presented more appropriately, and hopefully more clearly.
Line 69: Line 69:
'''Always''' sign your contributions to discussions using the string <nowiki>--~~~~</nowiki> at the end of your text.
'''Always''' sign your contributions to discussions using the string <nowiki>--~~~~</nowiki> at the end of your text.
-
===Code Highlighting===
+
===コードの構文強調===
We've installed a [http://www.mediawiki.org/wiki/Extension:SyntaxHighlight_GeSHi Syntax Highlighting extension]. This allows you to have nicer highlighting of many languages used in examples and code snippets on the wiki.
We've installed a [http://www.mediawiki.org/wiki/Extension:SyntaxHighlight_GeSHi Syntax Highlighting extension]. This allows you to have nicer highlighting of many languages used in examples and code snippets on the wiki.
Line 93: Line 93:
Note that the language name for HTML is <code>html4strict</code>, not just ‘HTML’. You can find the full list of supported languages on the Syntax Highlighter extension page: http://www.mediawiki.org/wiki/Extension:SyntaxHighlight_GeSHi#Supported_languages
Note that the language name for HTML is <code>html4strict</code>, not just ‘HTML’. You can find the full list of supported languages on the Syntax Highlighter extension page: http://www.mediawiki.org/wiki/Extension:SyntaxHighlight_GeSHi#Supported_languages
-
==Credits==
+
==クレジット==
The Wiki 2.0 project was implemented by [[User:BenWard]]. The visual style is derived from the original microformats.org theme by [http://simplebits.com Dan Cederholm]. The wiki also uses the wonderfully useful [http://famfamfam.com/lab/icons/silk//Fam Fam Fam Silk icons] by Mark James.
The Wiki 2.0 project was implemented by [[User:BenWard]]. The visual style is derived from the original microformats.org theme by [http://simplebits.com Dan Cederholm]. The wiki also uses the wonderfully useful [http://famfamfam.com/lab/icons/silk//Fam Fam Fam Silk icons] by Mark James.
-
==Issues==
+
==問題==
Please report, bugs issues and requests on the [[wiki-2-issues]] page.
Please report, bugs issues and requests on the [[wiki-2-issues]] page.

Revision as of 18:22, 18 November 2008


Microformats.org は、2005 年に生まれた最初の時以来、ほぼデフォルトの MediaWiki テーマで運営されてきました。数年を経て、wiki で公開される記事の種類は定まり、コミュニティでの編集の慣例もよく分かってきました。‘Wiki 2.0’ プロジェクトは、コミュニティが必要としていることに対応するべく wiki ソフトをアップデートし、これを機会に見た目も良くすることにしました。

Contents


変更の概要

Wiki 2.0 の使い方

The following tries to explain how best to use the new features in Wiki 2.0.

ページタイトル

Between version 1.4 and 1.13 MediaWiki fixed a bug whereby headings marked up with HTML elements were excluded from the generated Table of Contents on pages. We have since used H1 elements to override the headings of pages whilst not offsetting the TOC numbering into 1.1, 1.2, 1.3, etc. Since that bug is fixed, this hack has been replaced with a more robust mechanism.

Rather than use H1 elements to title your pages, instead use the new entry-title element. This is parsed by a MediaWiki extension and overrides the entry title as displayed on the page, whilst excluding it from the TOC. It is so named, because it corresponds to the entry-title element in the underlying hAtom that each entry is now marked up with.

仕様ページの書き方

The new wiki supports special display of specification documents, different from regular pages. The pages are styled more plainly and content spans the full width of the page, akin to documentation from the W3C, WHATWG and other bodies. The sidebar is pushed down into an expanded footer, so all functionality remains.

To enable these views, you must add your page to a particular category.

Please note that issues pages, brainstorming pages, straw-men and anything else not explicitly a Draft Specification or Specification document should not be added to these categories and should continue to be presented as regular wiki pages.

Categories should be declared at the base of articles, please.

議論と問題

Within documents discussions are often represented through nested lists. They are hard to follow, and hard to differentiate from the actual content of the document. You can now mark them up and have them presented more appropriately, and hopefully more clearly.

The following are examples to show the rendering:

  • I'm not happy with the phrasing of the above. --BenWard 09:50, 17 November 2008 (UTC)
    • I disagree, I think it's fine! --BenWard 09:50, 17 November 2008 (UTC)
  • New wiki does not support declarative creation of animated GIFs on profile pages. This is a big deal for me! --BenWard 09:50, 17 November 2008 (UTC)
    • No. Just… no! --BenWard 09:50, 17 November 2008 (UTC)

Always sign your contributions to discussions using the string --~~~~ at the end of your text.

コードの構文強調

We've installed a Syntax Highlighting extension. This allows you to have nicer highlighting of many languages used in examples and code snippets on the wiki.

  <source lang=html4strict>
  <div class="vcard">
    <a class="fn org" href="http://microformats.org">Microformats.org</a>
  </div>
  </source>

Produces:

<div class="vcard">
    <a class="fn org" href="http://microformats.org">Microformats.org</a>
  </div>

Note that the language name for HTML is html4strict, not just ‘HTML’. You can find the full list of supported languages on the Syntax Highlighter extension page: http://www.mediawiki.org/wiki/Extension:SyntaxHighlight_GeSHi#Supported_languages

クレジット

The Wiki 2.0 project was implemented by User:BenWard. The visual style is derived from the original microformats.org theme by Dan Cederholm. The wiki also uses the wonderfully useful Fam Fam Silk icons by Mark James.

問題

Please report, bugs issues and requests on the wiki-2-issues page.

Categories

Microformats.org Wiki 2.0 was last modified: Wednesday, December 31st, 1969

Views