Merge branch 'master' of github.com:scala/scala.github.com

Conflicts:
	ja/overviews/macros/quasiquotes.md

Author: xeno-by

.bundle/config

@@ -0,0 +1,3 @@
+---
+BUNDLE_PATH: vendor/bundle
+BUNDLE_DISABLE_SHARED_GEMS: '1'

.gitignore

@@ -3,3 +3,4 @@ _site
 .project
 .settings
 *~
+vendor/bundle

README.md

@@ -5,38 +5,58 @@ This repository contains the source for the Scala documentation website, as well
 ## Contributing ##
 
 Please have a look at [http://docs.scala-lang.org/contribute.html](http://docs.scala-lang.org/contribute.html) before making a contribution.
-This document gives an overview of the type of documentation contained within the Scala Documentation repository and the repository's structure.
+This document gives an overview of the type of documentation contained within the Scala Documentation repository, the repository's structure, and how to build and run the documentation locally. 
 
 Small changes, or corrected typos will generally be pulled in right away. Large changes, like the addition of new documents, or the rewriting of
 existing documents will be thoroughly reviewed-- please keep in mind that, generally, new documents must be very well-polished, complete, and maintained
 in order to be accepted.
 
 ## Dependencies ##
 
-Jekyll is required. Follow the install instructions at the Jekyll [documentation site](http://jekyllrb.com/docs/installation/).  Since this site is hosted on github pages, make sure you have [whatever version of Jekyll that github is running](https://help.github.com/articles/using-jekyll-with-pages#troubleshooting). As of the writing of this README, that is version >= 1.0.x.
+This site uses a Jekyll, a Ruby framework. You'll need Ruby and Bundler installed; see [Jekyll installation instructions](http://jekyllrb.com/docs/installation/) for the details.
 
 ## Building & Viewing ##
 
-cd into the `scala.github.com` directory, and build by:
+cd into the directory where you cloned this repository, then install the required gems with `bundle install`. This will automatically put the gems into `./vendor/bundle`.
 
-    jekyll serve
+Start the server in the context of the bundle:
+
+    bundle exec jekyll serve
 
 The generated site is available at `http://localhost:4000`
 
+Jekyll will automatically watch for changes on the filesystem, and regenerate the site. It can take a few minutes for your changes to appear. Watch the output from `jekyll serve`. When you start up you'll see this:
+
+     $ bundle exec jekyll serve
+     Configuration file: /Users/ben/src/scala.github.com/_config.yml
+                 Source: /Users/ben/src/scala.github.com
+            Destination: /Users/ben/src/scala.github.com/_site
+          Generating...
+                     done.
+    Auto-regeneration: enabled for '/Users/ben/src/scala.github.com'
+
+When you change a file, this output will tell you that jekyll is regenerating. It's not done until it says `done.`
+
+    Server running... press ctrl-c to stop.
+      Regenerating: 1 files at 2014-11-29 09:19:04 ...done.
+      Regenerating: 3 files at 2014-11-29 09:21:39 ...done.
+      Regenerating: 2 files at 2014-11-29 09:25:10 ...done.
+      Regenerating: 2 files at 2014-11-29 09:27:49
+
 If you get `incompatible encoding` errors when generating the site under Windows, then ensure that the
 console in which you are running jekyll can work with UTF-8 characters. As described in the blog
 [Solving UTF problem with Jekyll on Windows](http://joseoncode.com/2011/11/27/solving-utf-problem-with-jekyll-on-windows/)
 you have to execute `chcp 65001`. This command is best added to the `jekyll.bat`-script.
 
 ## Markdown ##
 
-The markdown used in this site uses [Maruku](http://maruku.rubyforge.org/maruku.html) extensions.
+The markdown used in this site uses [kramdown](http://kramdown.gettalong.org/) extensions.
 
 ### Markdown Editor for OSX ###
 
-There exists a free markdown editor for OSX called [Mou](http://mouapp.com/). It's quite convenient to work with, and it generates the translated Markdown in real-time alongside of your editor window, as can be seen here:
+There's a free markdown editor for OSX called [Mou](http://25.io/mou/). It's quite convenient to work with, and it generates the translated Markdown in real-time alongside of your editor window, as can be seen here:
 
-![Mou Screen Shot](http://mouapp.com/images/Mou_Screenshot_1.png)
+![Mou Screen Shot](http://25.io/mou/img/1.png)
 
 ## License ##
 

_config.yml

@@ -1,7 +1,7 @@
 markdown: kramdown
 
 title: "Scala Documentation"
-description: "Documentation for the Scala programming language- Tutorials, Overviews, Cheatsheets, and more."
+description: "Documentation for the Scala programming language - Tutorials, Overviews, Cheatsheets, and more."
 keywords:
 - Scala
 - Documentation
@@ -18,5 +18,4 @@ scala-version: 2.10.0
 highlighter: pygments
 permalink: /:categories/:title.html
 baseurl:
-
-# markdown: rdiscount
+exclude: ["vendor"]

_includes/header.txt

@@ -1,8 +1,7 @@
 <!DOCTYPE html>
 <html>
   <head>
-
-    <title>{% if page.partof %}{{ page.partof | replace: '-',' ' | split:" " | capitalize | join:" " }} - {% endif %}{% if page.title %}{{ page.title }} - {% endif %}{{ site.title }}</title>
+    <title>{% if page.partof %}{% assign words = page.partof | split: '-' %}{% for word in words %}{{ word | capitalize }} {% endfor %}- {% endif %}{% if page.title %}{{ page.title }} - {% endif %}{{ site.title }}</title>
     {% if page.description %}
     <meta name="description" content="{{ page.description }}" />
     {% endif %}
@@ -32,6 +31,10 @@
     <!-- table of contents js -->
     <script src="{{ site.baseurl }}/resources/javascript/toc.js" type="text/javascript" ></script>
 
+    <!-- styles for pager and table of contents -->
+    <link rel="stylesheet" href="{{ site.baseurl }}/resources/stylesheets/pager.css" type="text/css" />
+    <link rel="stylesheet" href="{{ site.baseurl }}/resources/stylesheets/toc.css" type="text/css" />
+
     <!-- google analytics -->
 	<script type="text/javascript">
 

_includes/tutorial-pager.txt

@@ -0,0 +1,10 @@
+<nav>
+  <ul class="pager">
+  {% if page.tutorial-previous %}
+      <li class="previous"><a href="{{ page.tutorial-previous }}.html""><span aria-hidden="true">&larr;</span> Previous</a></li>
+   {% endif %}
+   {% if page.tutorial-next %}
+      <li class="next"><a href="{{ page.tutorial-next }}.html">Next <span aria-hidden="true">&rarr;</span></a></li>
+   {% endif %}
+  </ul>
+</nav>

_includes/tutorial-tour-list.txt

@@ -9,7 +9,9 @@
   {% for i in (1..totalPagesTour) %}
     {% for pg in site.pages %}
       {% if pg.tutorial == "scala-tour" and pg.num and pg.num == i and pg.language == page.language %}
-        <li class="tour-of-scala"><a href="{{ pg.url }}">{{ pg.title }}</a></li>
+        <li class="tour-of-scala {% if page.title == pg.title %} current-page {% endif %}">
+          <a href="{{ pg.url }}">{{ pg.title }}</a>
+        </li>
       {% endif %}
     {% endfor %}
   {% endfor %}

_layouts/tutorial.html

@@ -34,6 +34,7 @@
 
       <div class="span10">
         {{ content }}
+        {% include tutorial-pager.txt %}
         {% if page.disqus == true %}{% include disqus.txt %}{% endif %}
       </div>
 

ja/overviews/index.md

@@ -5,8 +5,63 @@ title: ガイドと概要
 ---
 
 <div class="page-header-index">
-  <h1>コアライブラリ</h1>
+  <h2>コアライブラリ</h2>
 </div>
+   * Scala コレクションライブラリ
+     * [はじめに](/ja/overviews/collections/introduction.html)
+     * [可変コレクションおよび不変コレクション](/ja/overviews/collections/overview.html)
+     * [Traversable トレイト](/ja/overviews/collections/trait-traversable.html)
+     * [Iterable トレイト](/ja/overviews/collections/trait-iterable.html)
+     * [列トレイト Seq、IndexedSeq、および LinearSeq](/ja/overviews/collections/seqs.html)
+     * [集合](/ja/overviews/collections/sets.html)
+     * [マップ](/ja/overviews/collections/maps.html)
+     * [具象不変コレクションクラス](/ja/overviews/collections/concrete-immutable-collection-classes.html)
+     * [具象可変コレクションクラス](/ja/overviews/collections/concrete-mutable-collection-classes.html)
+     * [配列](/ja/overviews/collections/arrays.html)
+     * [文字列](/ja/overviews/collections/strings.html)
+     * [性能特性](/ja/overviews/collections/performance-characteristics.html)
+     * [等価性](/ja/overviews/collections/equality.html)
+     * [ビュー](/ja/overviews/collections/views.html)
+     * [イテレータ](/ja/overviews/collections/iterators.html)
+     * [コレクションの作成](/ja/overviews/collections/creating-collections-from-scratch.html)
+     * [Java と Scala 間のコレクションの変換](/ja/overviews/collections/conversions-between-java-and-scala-collections.html)
+     * [Scala 2.7 からの移行](/ja/overviews/collections/migrating-from-scala-27.html)
+   * [文字列の補間](/ja/overviews/core/string-interpolation.html) <span class="label success">New in 2.10</span>
+   * [値クラスと汎用トレイト](/ja/overviews/core/value-classes.html) <span class="label success">New in 2.10</span>
+ 
+ <div class="page-header-index">
+   <h2>並列および並行プログラミング</h2>
+ </div>
+   * [Future と Promise](/ja/overviews/core/futures.html) <span class="label success">New in 2.10</span>
+   * Scala 並列コレクションライブラリ
+     * [概要](/ja/overviews/parallel-collections/overview.html)
+     * [具象並列コレクションクラス](/ja/overviews/parallel-collections/concrete-parallel-collections.html)
+     * [並列コレクションへの変換](/ja/overviews/parallel-collections/conversions.html)
+     * [並行トライ](/ja/overviews/parallel-collections/ctries.html)
+     * [並列コレクションライブラリのアーキテクチャ](/ja/overviews/parallel-collections/architecture.html)
+     * [カスタム並列コレクションの作成](/ja/overviews/parallel-collections/custom-parallel-collections.*tml)
+     * [並列コレクションの設定](/ja/overviews/parallel-collections/configuration.html)
+     * [性能の測定](/ja/overviews/parallel-collections/performance.html)
 
-{% include localized-overview-index.txt %}
-<!--* Swing <span class="label important">In Progress</span>-->
+ <div class="page-header-index">
+   <h2>メタプログラミング</h2>
+ </div>
+   * リフレクション <span class="label important">Experimental</span>
+     * [概要](/ja/overviews/reflection/overview.html)
+     * [環境、ユニバース、ミラー](/ja/overviews/reflection/environment-universes-mirrors.html)
+     * [シンボル、構文木、型](/ja/overviews/reflection/symbols-trees-types.html)
+     * [アノテーション、名前、スコープ、その他](/ja/overviews/reflection/annotations-names-scopes.html)
+     * [型タグとマニフェスト](/ja/overviews/reflection/typetags-manifests.html)
+     * [スレッドセーフティ](/ja/overviews/reflection/thread-safety.html)
+   * マクロ <span class="label important">Experimental</span>
+     * [ユースケース](/ja/overviews/macros/usecases.html)
+     * [blackbox vs whitebox](/ja/overviews/macros/blackbox-whitebox.html)
+     * [def マクロ](/ja/overviews/macros/overview.html)
+     * [準クォート](/ja/overviews/macros/quasiquotes.html)
+     * [マクロバンドル](/ja/overviews/macros/bundles.html)
+     * [implicit マクロ](/ja/overviews/macros/implicits.html)
+     * [抽出子マクロ](/ja/overviews/macros/extractors.html)
+     * [型プロバイダ](/ja/overviews/macros/typeproviders.html)
+     * [マクロアノテーション](/ja/overviews/macros/annotations.html)
+     * [マクロパラダイス](/ja/overviews/macros/paradise.html)
+     * [ロードマップ](/ja/overviews/macros/roadmap.html)

ja/overviews/macros/annotations.md

@@ -5,24 +5,20 @@ language: ja
 disqus: true
 
 partof: macros
-num: 6
-outof: 8
+num: 9
+outof: 11
+
 title: マクロアノテーション
 ---
 <span class="label important" style="float: right;">MACRO PARADISE</span>
 
 **Eugene Burmako 著**<br>
 **Eugene Yokota 訳**
 
-マクロアノテーションは現在マクロパラダイスプラグインを使った Scala 2.10 からのみ利用可能だ。
-Scala 2.11 にこの機能が含まれる可能性はあるが、この件に関してのロードマップははっきりしてない。
+マクロアノテーションはマクロパラダイスプラグインからのみ利用可能だ (Scala 2.10.x、2.11.x、2.12.x 系列全て同様)。
+この機能が正式な Scala に入る可能性は、Scala 2.13 には残されているが、一切保証されていない。
 [マクロパラダイス](/ja/overviews/macros/paradise.html)ページの説明にしたがってコンパイラプラグインをダウンロードしてほしい。
 
-## コメント募集中
-
-マクロアノテーションの現行の実装は実験的なものであり (それ故、現行のマクロパラダイスのバージョンも `2.0.0-SNAPSHOT` というスナップショット扱いされている)、今後の Scala 2.11 もしくは 2.12 への Scala improvement proposal を提出する上でのプレビューそして「たたき台」としての役割を果たすことを目的としている。
-コード生成のニーズを満たすことができるか是非試してみて、何かうまくいかない点があれば <a href="https://twitter.com/#!/xeno_by">Twitter</a> で著者に報告してほしい。
-
 ## 一巡り
 
 マクロアノテーションは定義レベルでテキスト抽象化を実現する。Scala がマクロだと認識可能な定義であればトップレベルでも入れ子の定義でも、このアノテーションを付けることで (1つまたは複数の) メンバに展開させることができる。マクロパラダイスの以前のバージョンと比較して、2.0 のマクロパラダイスは以下の点を改善した:
@@ -106,3 +102,8 @@ Scala 2.11 にこの機能が含まれる可能性はあるが、この件に関
 
 Scala マクロの精神に則り、マクロアノテーションは柔軟性のために可能な限り型指定を無くし (untyped; マクロ展開前に型検査を必須としないこと)、利便性のために可能な限り型付けた (typed; マクロ展開前に利用可能な型情報を取得すること)。注釈対象は型指定が無いため、後付けでシグネチャ (例えばクラスメンバのリストなど) を変更できる。しかし、Scala マクロを書くということはタイプチェッカと統合するということであり、マクロアノテーションもそれは同じだ。そのため、マクロ展開時には全ての型情報を得ることができる
 (例えば、包囲するプログラムに対してリフレクションを使ったり、現行スコープ内から型検査を行ったり、implicit の検索を行うことができる)。
+
+## blackbox vs whitebox
+
+マクロアノテーションは [whitebox](/ja/overviews/macros/blackbox-whitebox.html) である必要がある。
+マクロアノテーションを [blackbox](/ja/overviews/macros/blackbox-whitebox.html) だと宣言すると正しく動作しない。