Merge pull request #3 from sveltejs-cn/ywl_branch

合并翻译

Author: tgxpuisb

SUMMARY.md

@@ -3,4 +3,20 @@
 * [开始之前](README.md)
 * [第一章](chapter1/README.md)
  * [section1](chapter1/section1.md)
- * [section2](chapter1/section2.md)
+ * [section2](chapter1/section2.md)
+* [模版语法](chapter2/README.md)
+ * [Classes](chapter2/Classes.md)
+ * [Actions](chapter2/Actions.md)
+ * [Transitions](chapter2/Transitions.md)
+ * [Transition参数](chapter2/Transitions.md#Transition参数)
+ * [自定义过渡函数](chapter2/Transitions.md#自定义过渡函数)
+ * [Transition事件](chapter2/Transitions.md#Transition事件)
+ * [Animations](chapter2/Animations.md)
+ * [Animation参数](chapter2/Animations.md#Animation参数)
+ * [自定义Animation函数](chapter2/Animations.md#自定义Animation函数)
+ * [svelte:self](chapter2/svelte-self.md)
+ * [svelte:component](chapter2/svelte-component.md)
+ * [svelte:window](chapter2/svelte-window.md)
+ * [svelte:body](chapter2/svelte-body.md)
+ * [svelte:head](chapter2/svelte-head.md)
+ * [svelte:options](chapter2/svelte-options.md)

_book/chapter1/component-format.md

@@ -0,0 +1,64 @@
+# 在开始之前：
+
+注意：此文档目前还是半成品。如遇到缺失或有误导的部分敬请谅解，并且勇于在聊天室寻求帮助，这些教程会更加完善。那么，开始学习吧：
+
+以下页面包含详细的API说明文档，主要是给已经初步接触过Svelte的人们提供的资源。
+
+如果你还没有接触过Svelte，你可以在查阅这些资料前先访问这个可交互的教程或者例子。
+
+# 组件格式
+
+组件是Svelte应用的内置区块，是使用HTML的扩展格式的语言写成.svelte文件
+
+一共分为三个区域、script、style和标签（选填）
+
+## script
+
+一个`script`区域含有一个组件实例创建时的运行Javascript代码。
+变量申明（或者引入的变量）在组件标签顶部显示申明。
+这里有4条规则：
+
+1. export 用来申明组件的属性
+
+Svelte 使用 export 这个关键字标识一个变量申明作为组件的属性prop，这意味着组件的使用者通过属性可以访问它。
+
+赋值分配是响应式的
+
+改变组件的state并触发组件重新渲染，只需要给本地的已申明变量赋值
+
+使用表达式（count += 1）更新count的值和给属性赋值（obj.x = y）是等效的。
+
+因为Svelte的响应式是基于赋值操作的，使用属性方法如 .push 和 .splice 将不会自动触发更新。有关解决此问题的选项，可以参考此教程
+
+3 使用 $ 将表达式设为响应式的
+
+任何顶层的表达式（不包含代码块和函数申明）可以通过一个$符号设置成响应式的。这是js的标签语法。当响应式表达式依赖的值发生变化时，它们会在组件更新前立即执行。
+
+如果一个表达式是一条由完全未申明的变量组成的赋值语句，Svelte会替你插入一个let申明。
+
+4 为Store添加$前缀来访问它们的值
+
+任何时候，对于任意一个Store，你都可以在组件内部为该Store的引用添加$字符前缀来访问它的值。这会导致Svelte申明有前缀的变量，并且会设置一个Store订阅然后再适当的时候会取消这个订阅。
+
+要注意，必须在组件的顶层申明Store，并且不可以包含在if代码块中
+
+本地申明的变量（不代指store的值）不允许还有$前缀
+
+## <script context="module">
+
+一个带有`context="module"`属性的`<script>`标签的模块只会执行一次，而不是每次都生成组件实例。在此模块中申明的Values可以被正常的`<script>`标签访问到（包括组件标签）但是反之则无法这么使用。
+
+你可以从此区块中 导出 这些绑定值，并且他们会成为编译的模块的导出值
+
+你不能 export default 因为默认导出的是组件本身
+
+
+## <style>
+
+写在`<style>`中的CSS与组件外部是隔离的
+
+这个功能是通过给元素添加带有组件style哈希的class来实现的。eg（svelte-123xyz）
+
+可以通过使用`:global(...)`修饰符将样式作用域全局
+
+

_book/chapter1/index.html

@@ -147,6 +147,232 @@
 
  </li>
 
+ <li class="chapter " data-level="1.3" data-path="../chapter2/README.md">
+ 
+ <span>
+ 
+ 
+ 模版语法
+ 
+ </a>
+ 
+
+ 
+ <ul class="articles">
+ 
+ 
+ <li class="chapter " data-level="1.3.1" data-path="../chapter2/Classes.html">
+ 
+ <a href="../chapter2/Classes.html">
+ 
+ 
+ Classes
+ 
+ </a>
+ 
+
+ 
+ </li>
+ 
+ <li class="chapter " data-level="1.3.2" data-path="../chapter2/Actions.html">
+ 
+ <a href="../chapter2/Actions.html">
+ 
+ 
+ Actions
+ 
+ </a>
+ 
+
+ 
+ </li>
+ 
+ <li class="chapter " data-level="1.3.3" data-path="../chapter2/Transitions.html">
+ 
+ <a href="../chapter2/Transitions.html">
+ 
+ 
+ Transitions
+ 
+ </a>
+ 
+
+ 
+ <ul class="articles">
+ 
+ 
+ <li class="chapter " data-level="1.3.3.1" data-path="../chapter2/Transitions.html">
+ 
+ <a href="../chapter2/Transitions.html#Transition参数">
+ 
+ 
+ Transition参数
+ 
+ </a>
+ 
+
+ 
+ </li>
+ 
+ <li class="chapter " data-level="1.3.3.2" data-path="../chapter2/Transitions.html">
+ 
+ <a href="../chapter2/Transitions.html#自定义过渡函数">
+ 
+ 
+ 自定义过渡函数
+ 
+ </a>
+ 
+
+ 
+ </li>
+ 
+ <li class="chapter " data-level="1.3.3.3" data-path="../chapter2/Transitions.html">
+ 
+ <a href="../chapter2/Transitions.html#Transition事件">
+ 
+ 
+ Transition事件
+ 
+ </a>
+ 
+
+ 
+ </li>
+ 
+
+ </ul>
+ 
+ </li>
+ 
+ <li class="chapter " data-level="1.3.4" data-path="../chapter2/Animations.html">
+ 
+ <a href="../chapter2/Animations.html">
+ 
+ 
+ Animations
+ 
+ </a>
+ 
+
+ 
+ <ul class="articles">
+ 
+ 
+ <li class="chapter " data-level="1.3.4.1" data-path="../chapter2/Animations.html">
+ 
+ <a href="../chapter2/Animations.html#Animation参数">
+ 
+ 
+ Animation参数
+ 
+ </a>
+ 
+
+ 
+ </li>
+ 
+ <li class="chapter " data-level="1.3.4.2" data-path="../chapter2/Animations.html">
+ 
+ <a href="../chapter2/Animations.html#自定义Animation函数">
+ 
+ 
+ 自定义Animation函数
+ 
+ </a>
+ 
+
+ 
+ </li>
+ 
+
+ </ul>
+ 
+ </li>
+ 
+ <li class="chapter " data-level="1.3.5" data-path="../chapter2/svelte-self.html">
+ 
+ <a href="../chapter2/svelte-self.html">
+ 
+ 
+ svelte:self
+ 
+ </a>
+ 
+
+ 
+ </li>
+ 
+ <li class="chapter " data-level="1.3.6" data-path="../chapter2/svelte-component.html">
+ 
+ <a href="../chapter2/svelte-component.html">
+ 
+ 
+ svelte:component
+ 
+ </a>
+ 
+
+ 
+ </li>
+ 
+ <li class="chapter " data-level="1.3.7" data-path="../chapter2/svelte-window.html">
+ 
+ <a href="../chapter2/svelte-window.html">
+ 
+ 
+ svelte:window
+ 
+ </a>
+ 
+
+ 
+ </li>
+ 
+ <li class="chapter " data-level="1.3.8" data-path="../chapter2/svelte-body.html">
+ 
+ <a href="../chapter2/svelte-body.html">
+ 
+ 
+ svelte:body
+ 
+ </a>
+ 
+
+ 
+ </li>
+ 
+ <li class="chapter " data-level="1.3.9" data-path="../chapter2/svelte-head.html">
+ 
+ <a href="../chapter2/svelte-head.html">
+ 
+ 
+ svelte:head
+ 
+ </a>
+ 
+
+ 
+ </li>
+ 
+ <li class="chapter " data-level="1.3.10" data-path="../chapter2/svelte-options.html">
+ 
+ <a href="../chapter2/svelte-options.html">
+ 
+ 
+ svelte:options
+ 
+ </a>
+ 
+
+ 
+ </li>
+ 
+
+ </ul>
+ 
+ </li>
+ 
 
 
 
@@ -236,7 +462,7 @@ <h1 class="search-results-title">No results matching "<span class='search-query'
  <script>
  var gitbook = gitbook || [];
  gitbook.push(function() {
- gitbook.page.hasChanged({"page":{"title":"第一章","level":"1.2","depth":1,"next":{"title":"section1","level":"1.2.1","depth":2,"path":"chapter1/section1.md","ref":"chapter1/section1.md","articles":[]},"previous":{"title":"开始之前","level":"1.1","depth":1,"path":"README.md","ref":"README.md","articles":[]},"dir":"ltr"},"config":{"gitbook":"*","theme":"default","variables":{},"plugins":["livereload"],"pluginsConfig":{"livereload":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"structure":{"langs":"LANGS.md","readme":"README.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"}},"file":{"path":"chapter1/README.md","mtime":"2019-05-21T12:18:22.563Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2019-05-21T13:59:45.480Z"},"basePath":"..","book":{"language":""}});
+ gitbook.page.hasChanged({"page":{"title":"第一章","level":"1.2","depth":1,"next":{"title":"section1","level":"1.2.1","depth":2,"path":"chapter1/section1.md","ref":"chapter1/section1.md","articles":[]},"previous":{"title":"开始之前","level":"1.1","depth":1,"path":"README.md","ref":"README.md","articles":[]},"dir":"ltr"},"config":{"gitbook":"*","theme":"default","variables":{},"plugins":["livereload"],"pluginsConfig":{"livereload":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"structure":{"langs":"LANGS.md","readme":"README.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"}},"file":{"path":"chapter1/README.md","mtime":"2019-05-21T13:49:52.000Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2019-05-26T08:50:57.845Z"},"basePath":"..","book":{"language":""}});
  });
  </script>
 </div>