按照新的排序情况对项目内容进行重新规划

LINKS.md

@@ -1,20 +1,23 @@
-# Links
+# 参考链接
 
-In this page, we provide the quick reference link can help you increase ability to learning and coding.
+在项目的推进过程中，总会参考其他用户和网站的资源。
 
-## JDK
+在这个页面中对相关的资源提供快速参考的链接。
 
-| Webiste | Links                                               |
-|---------|-----------------------------------------------------|
-| Oracle  | https://www.oracle.com/java/technologies/downloads/ |
-| OpenJDK | https://adoptium.net/temurin/releases/              |
+## 中文历史 Fork 仓库
 
+文档中的内容没有完全重新开始构建，我们是在基于 https://github.com/5-say/composer-doc-cn 仓库的基础上进行更新的。
 
-## Useful Links
+主要的原因是因为当前项目的需要我们也需要使用 composer 项目，但中文文档也比较来了。
 
-| Webiste        | Links                                           |
-|----------------|-------------------------------------------------|
-| Eclipse        | https://www.eclipse.org/                        |
-| GitHub         | https://github.com/                             |
-| stackoverflow  | https://stackoverflow.com/questions/tagged/java |
-| Apache Commons | https://commons.apache.org/                     |
+对用户来说，其实也没有关系了，因为用的命令也就那么几个，但我们想利用这个契机把文档和我们的问题更新一下。
+
+## 参考网站列表
+
+对在使用 composer 内容比较多的网站，我们在次列出。
+
+| 网站名称          | 链接                                       |
+|---------------|------------------------------------------|
+| iSharkFly     | https://www.isharkfly.com/tag/composer   |
+| Laravel中文网    | http://www.golaravel.com                 |
+| Composer 中文文档 | https://github.com/5-say/composer-doc-cn |

README.md

@@ -22,27 +22,27 @@ Composer 中文文档
 - [社区](/cn-introduction/06-community.md)
 
 ## Articles
-- [别名](/cn-introduction/articles/aliases.md)  
+- [别名](/articles/aliases.md)  
 版本分支名称的别名。
-- [自定义安装程序](/cn-introduction/articles/custom-installers.md)  
+- [自定义安装程序](/articles/custom-installers.md)  
 修改某些特殊类型包的安装方式。
-- [Handling Private Packages With Satis](/cn-introduction/articles/handling-private-packages-with-satis.md)  
+- [Handling Private Packages With Satis](/articles/handling-private-packages-with-satis.md)  
 Host your own composer repository
-- [插件](/cn-introduction/articles/plugins.md)  
+- [插件](/articles/plugins.md)  
 修改和扩展 Composer 的功能。
-- [脚本](/cn-introduction/articles/scripts.md)  
+- [脚本](/articles/scripts.md)  
 脚本是指一些 Composer 事件的回调，它们在安装资源包的过程中被触发执行。
-- [Troubleshooting](/cn-introduction/articles/troubleshooting.md)  
+- [Troubleshooting](/articles/troubleshooting.md)  
 Solving problems
-- [二进制供应库](/cn-introduction/articles/vendor-binaries.md)  
+- [二进制供应库](/articles/vendor-binaries.md)  
 从资源包中暴露命令行脚本。
 
 ## FAQs
 
-- [如何为我的框架自定义一个资源包安装目录？](/cn-introduction/faqs/how-do-i-install-a-package-to-a-custom-path-for-my-framework.md)
-- [我应该提交 vendor 目录中的依赖包吗？](/cn-introduction/faqs/should-i-commit-the-dependencies-in-my-vendor-directory.md)
-- [为什么说“比较符”和“通配符”相结合的版本约束是坏主意？](/cn-introduction/faqs/why-are-version-constraints-combining-comparisons-and-wildcards-a-bad-idea.md)
-- [为什么 Composer 不递归加载储存库？](/cn-introduction/faqs/why-can%27t-composer-load-repositories-recursively.md)
+- [如何为我的框架自定义一个资源包安装目录？](/faq/how-do-i-install-a-package-to-a-custom-path-for-my-framework.md)
+- [我应该提交 vendor 目录中的依赖包吗？](/faq/should-i-commit-the-dependencies-in-my-vendor-directory.md)
+- [为什么说“比较符”和“通配符”相结合的版本约束是坏主意？](/faq/why-are-version-constraints-combining-comparisons-and-wildcards-a-bad-idea.md)
+- [为什么 Composer 不递归加载储存库？](/faq/why-can%27t-composer-load-repositories-recursively.md)
 
 ## 相关文章推荐
 

_sidebar.md

@@ -1,11 +1,10 @@
-- HIS 医疗数据信息化
-  - [Readme](README.md)
-  - [Contact](CONTACT.md)
-- [FHIR In Action](fhir-in-action/index.md)
+- Composer 中文文档
+  - [项目自述](README.md)
+  - [联系我们](CONTACT.md)
+  - [参考链接](LINKS.md)
 - [Week 2](week-2/index.md)
 - [Week 3](week-3/index.md)
 - [Week 4](week-4/_index.md)
 - Week 5
 - Week 6
-- Week 7
-- [Links](LINKS.md)
+- [FAQ](faq/_index.md)

articles/_index.md

@@ -1,4 +1,4 @@
-# FHIR In Action
+# 相关文章
 ---
 
 针对 FHIR 标准的指南和示例以及相关内容的讨论。

articles/_sidebar.md

@@ -0,0 +1,9 @@
+- [FHIR 简介](/fhir-in-action/introduction/index.md)
+  - [开发者眼中的 FHIR](/fhir-in-action/introduction/toreader.md)
+  - [FHIR 实现](/fhir-in-action/introduction/fhir-mplementation.md)
+  - [FHIR 概述](/fhir-in-action/introduction/fhir-overview.md)
+  - [FHIR 开发者指南](/fhir-in-action/introduction/fhir-dev-guide.md)
+  - [开放数据](/fhir-in-action/introduction/open-data-is-coming.md)
+- [Install JDK](/fhir-in-action/install_jdk.md)
+- [Install Eclipse](/fhir-in-action/introduction/install_eclipse.md)
+- [Naming Conventions](/fhir-in-action/naming_conventions.md)

articles/custom-installers.md

@@ -158,8 +158,8 @@ class TemplateInstaller extends LibraryInstaller
 
 > _并非安装在 `/vendor` 目录，任何使用这个安装程序的资源包，将被放置在 `/data/templates/<stripped name>` 目录中。_
 
-[1]: ../04-schema.md#type
-[2]: ../04-schema.md#extra
+[1]: ../cn-introduction/04-schema.md#type
+[2]: ../cn-introduction/04-schema.md#extra
 [3]: https://github.com/composer/composer/blob/master/src/Composer/Plugin/PluginInterface.php
 [4]: https://github.com/composer/composer/blob/master/src/Composer/Installer/InstallerInterface.php
 [5]: https://github.com/composer/composer/blob/master/src/Composer/Installer/LibraryInstaller.php

articles/handling-private-packages-with-satis.md

@@ -18,10 +18,10 @@ Satis 是一个静态的 `composer` 代码库生成器。
 For example let's assume you have a few packages you want to reuse across your
 company but don't really want to open-source. You would first define a Satis
 configuration: a json file with an arbitrary name that lists your curated 
-[repositories](../05-repositories.md).
+[repositories](../cn-introduction/05-repositories.md).
 
 Here is an example configuration, you see that it holds a few VCS repositories,
-but those could be any types of [repositories](../05-repositories.md). Then it
+but those could be any types of [repositories](../cn-introduction/05-repositories.md). Then it
 uses `"require-all": true` which selects all versions of all packages in the
 repositories you defined.
 

articles/plugins.md

@@ -124,10 +124,10 @@ class AwsPlugin implements PluginInterface, EventSubscriberInterface
 
 > 你可以通过 `--no-plugins` 选项让 composer 的命令禁用所有已经安装的插件。这或许是特别有用的，如果任何插件会导致错误，而你想要升级或卸载它。
 
-[1]: ../04-schema.md#type
-[2]: ../04-schema.md#extra
+[1]: ../cn-introduction/04-schema.md#type
+[2]: ../cn-introduction/04-schema.md#extra
 [3]: https://github.com/composer/composer/blob/master/src/Composer/Plugin/PluginInterface.php
 [4]: https://github.com/composer/composer/blob/master/src/Composer/Composer.php
 [5]: https://github.com/composer/composer/blob/master/src/Composer/IO/IOInterface.php
 [6]: https://github.com/composer/composer/blob/master/src/Composer/EventDispatcher/EventSubscriberInterface.php
-[7]: ./scripts.md#event-names
+[7]: scripts.md#event-names

articles/troubleshooting.md

@@ -7,11 +7,11 @@ This is a list of common pitfalls on using Composer, and how to avoid them.
 
 ## General
 
-1. Before asking anyone, run [`composer diagnose`](../03-cli.md#diagnose) to check
+1. Before asking anyone, run [`composer diagnose`](../cn-introduction/03-cli.md#diagnose) to check
    for common problems. If it all checks out, proceed to the next steps.
 
 2. When facing any kind of problems using Composer, be sure to **work with the
-   latest version**. See [self-update](../03-cli.md#self-update) for details.
+   latest version**. See [self-update](../cn-introduction/03-cli.md#self-update) for details.
 
 3. Make sure you have no problems with your setup by running the installer's
    checks via `curl -sS https://getcomposer.org/installer | php -- --check`.
@@ -27,7 +27,7 @@ This is a list of common pitfalls on using Composer, and how to avoid them.
    branches and tag names.
 
 2. Be sure to **set the right
-   [minimum-stability](../04-schema.md#minimum-stability)**. To get started or be
+   [minimum-stability](../cn-introduction/04-schema.md#minimum-stability)**. To get started or be
    sure this is no issue, set `minimum-stability` to "dev".
 
 3. Packages **not coming from [Packagist](https://packagist.org/)** should

cn-introduction/02-libraries.md

@@ -110,7 +110,7 @@ hg) 的信息推断出包的版本，因此你不必手动指明版本号，并
 
 它表示一个包版本的别名。例如，你可以为 `dev-master` 设置别名 `1.0.x-dev`，这样就可以通过 require `1.0.x-dev` 来得到 `dev-master` 版本的包。
 
-详细请查看[“别名”](articles/aliases.md)。
+详细请查看[“别名”](../articles/aliases.md)。
 
 <a name="Lock-file"></a>
 ## 锁文件

cn-introduction/03-cli.md

@@ -434,7 +434,7 @@ php composer.phar create-project doctrine/orm path 2.2.*
 <a name="run-script"></a>
 ## 执行脚本 `run-script`
 
-你可以运行此命令来手动执行 [脚本](articles/scripts.md)，只需要指定脚本的名称，可选的 `--no-dev` 参数允许你禁用开发者模式。
+你可以运行此命令来手动执行 [脚本](../articles/scripts.md)，只需要指定脚本的名称，可选的 `--no-dev` 参数允许你禁用开发者模式。
 
 <a name="diagnose"></a>
 ## 诊断 `diagnose`
@@ -498,7 +498,7 @@ COMPOSER=composer-other.json php composer.phar install
 <a name="COMPOSER_BIN_DIR"></a>
 ### COMPOSER_BIN_DIR
 
-通过设置这个环境变量，你可以指定 `bin`（[Vendor Binaries](articles/vendor-binaries.md)）目录到 `vendor/bin` 以外的其它目录。
+通过设置这个环境变量，你可以指定 `bin`（[Vendor Binaries](../articles/vendor-binaries.md)）目录到 `vendor/bin` 以外的其它目录。
 
 <a name="http_proxy-or-HTTP_PROXY"></a>
 ### http_proxy or HTTP_PROXY

cn-introduction/04-schema.md

@@ -120,7 +120,7 @@ composer 原生支持以下4种类型：
 - **library:** 这是默认类型，它会简单的将文件复制到 `vendor` 目录。
 - **project:** 这表示当前包是一个项目，而不是一个库。例：框架应用程序 [Symfony standard edition](https://github.com/symfony/symfony-standard)，内容管理系统 [SilverStripe installer](https://github.com/silverstripe/silverstripe-installer) 或者完全成熟的分布式应用程序。使用 IDE 创建一个新的工作区时，这可以为其提供项目列表的初始化。
 - **metapackage:** 当一个空的包，包含依赖并且需要触发依赖的安装，这将不会对系统写入额外的文件。因此这种安装类型并不需要一个 dist 或 source。
-- **composer-plugin:** 一个安装类型为 `composer-plugin` 的包，它有一个自定义安装类型，可以为其它包提供一个 installler。详细请查看 [自定义安装类型](articles/custom-installers.md)。
+- **composer-plugin:** 一个安装类型为 `composer-plugin` 的包，它有一个自定义安装类型，可以为其它包提供一个 installler。详细请查看 [自定义安装类型](../articles/custom-installers.md)。
 
 仅在你需要一个自定义的安装逻辑时才使用它。建议忽略这个属性，采用默认的 `library`。
 
@@ -334,7 +334,7 @@ composer 原生支持以下4种类型：
 > 正因为如此，在某些情况下，它不会是一个实用的解决方法，
 > 如果可能，你应该总是尝试切换到拥有标签的版本。
 
-它也可以应用于行内别名，这样它将匹配一个约束，否则不会。更多信息请参考 [别名](articles/aliases.md)。
+它也可以应用于行内别名，这样它将匹配一个约束，否则不会。更多信息请参考 [别名](../articles/aliases.md)。
 
 <a name="require"></a>
 #### require
@@ -694,7 +694,7 @@ Repositories 并不是递归调用的，只能在“Root包”的 `composer.json
 * **github-oauth:** 一个域名和 oauth keys 的列表。
   例如：使用 `{"github.com": "oauthtoken"}` 作为此选项的值，
   将使用 `oauthtoken` 来访问 github 上的私人仓库，并绕过 low IP-based rate 的 API 限制。
-  [关联知识](articles/troubleshooting.md#api-rate-limit-and-oauth-tokens)
+  [关联知识](../articles/troubleshooting.md#api-rate-limit-and-oauth-tokens)
   关于如何获取 GitHub 的 OAuth token。
 * **vendor-dir:** 默认为 `vendor`。通过设置你可以安装依赖到不同的目录。
 * **bin-dir:** 默认为 `vendor/bin`。如果一个项目包含二进制文件，它们将被连接到这个目录。
@@ -727,7 +727,7 @@ Repositories 并不是递归调用的，只能在“Root包”的 `composer.json
 
 Composer 允许你在安装过程中的各个阶段挂接脚本。
 
-更多细节和案例请查看 [脚本](articles/scripts.md)。
+更多细节和案例请查看 [脚本](../articles/scripts.md)。
 
 <a name="extra"></a>
 ### extra
@@ -747,7 +747,7 @@ $extra = $event->getComposer()->getPackage()->getExtra();
 
 该属性用于标注一组应被视为二进制脚本的文件，他们会被软链接到（config 对象中的）`bin-dir` 属性所标注的目录，以供其他依赖包调用。
 
-详细请查看 [Vendor Binaries](articles/vendor-binaries.md)。
+详细请查看 [Vendor Binaries](../articles/vendor-binaries.md)。
 
 可选。
 

cn-introduction/05-repositories.md

@@ -59,7 +59,7 @@ Composer 是一个依赖管理工具。它在本地安装一些资源包。一
 
 默认情况下已经将 Packagist.org 注册到 Composer。你可以在 `composer.json` 中申明更多的资源库，把它们加入你的项目中。
 
-资源库的定义仅可用于“root 包”，而在你依赖的包中定义的资源库将不会被加载。如果你想了解其中的原因，请阅读 [FAQ entry](faqs/why-can't-composer-load-repositories-recursively.md)。
+资源库的定义仅可用于“root 包”，而在你依赖的包中定义的资源库将不会被加载。如果你想了解其中的原因，请阅读 [FAQ entry](../faq/why-can't-composer-load-repositories-recursively.md)。
 
 <a name="Types"></a>
 ## Types
@@ -241,7 +241,7 @@ VCS 表示版本控制系统。这包括像 git、svn 或 hg 这样的版本管
 
 注意，你不应该对包进行重命名，除非你真的打算摆脱原来的包，并长期的使用你自己的 fork。这样 Composer 就会正确获取你的包了。如果你确定要重命名这个包，你应该在默认分支（通常是 master 分支）上操作，而不是特性分支，因为包的名字取自默认分支。
 
-如果其它包依赖你 fork 的这个分支，可能要对它做版本号的行内别名设置，才能够准确的识别版本约束。更多相关信息请查看 [别名](articles/aliases.md)。
+如果其它包依赖你 fork 的这个分支，可能要对它做版本号的行内别名设置，才能够准确的识别版本约束。更多相关信息请查看 [别名](../articles/aliases.md)。
 
 <a name="Using-private"></a>
 #### 使用私有资源库
@@ -456,7 +456,7 @@ Satis 是一个静态的 `composer` 资源库生成器。它像是一个超轻
 
 你给它一个包含 `composer.json` 的存储库，定义好 VCS 和 资源库。它会获取所有你列出的包，并打印 `packages.json` 文件，作为 `composer` 类型的资源库。
 
-更多详细信息请查看 [github.com/composer/satis](https://github.com/composer/satis) 和 [Satis article](articles/handling-private-packages-with-satis.md)。
+更多详细信息请查看 [github.com/composer/satis](https://github.com/composer/satis) 和 [Satis article](../articles/handling-private-packages-with-satis.md)。
 
 <a name="Artifact"></a>
 ### Artifact

faq/_index.md

@@ -0,0 +1,6 @@
+# FAQ
+
+- [如何为我的框架自定义一个资源包安装目录](/faq/how-do-i-install-a-package-to-a-custom-path-for-my-framework.md)
+- [我应该提交 vendor 目录中的依赖包吗](/faq/should-i-commit-the-dependencies-in-my-vendor-directory.md)
+- [为什么说“比较符”和“通配符”相结合的版本约束是坏主意](/faq/why-are-version-constraints-combining-comparisons-and-wildcards-a-bad-idea.md)
+- [为什么 Composer 不递归加载储存库](/faq/why-can't-composer-load-repositories-recursively.md)

faq/should-i-commit-the-dependencies-in-my-vendor-directory.md

@@ -13,6 +13,6 @@
 如果你真的觉得你必须这样做，你有几个选择：
 
 1. 限制自己安装标记版本（无 dev 版本），这样你只会得到 zip 压缩的安装，并避免 git“子模块”出现的问题。
-2. 使用 --prefer-dist 或在 [config](../04-schema.md#config) 选项中设置 `preferred-install` 为 `dist`。
+2. 使用 --prefer-dist 或在 [config](../cn-introduction/04-schema.md#config) 选项中设置 `preferred-install` 为 `dist`。
 3. 在每一个依赖安装后删除其下的 `.git` 文件夹，然后你就可以添加它们到你的 git repo 中。你可以运行 `rm -rf vendor/**/.git` 命令快捷的操作，但这意味着你在运行 composer update 命令前需要先删除磁盘中的依赖文件。
 4. 新增一个 .gitignore 规则（`vendor/.git`）来忽略 vendor 下所有 `.git` 目录。这种方法不需要你在运行 composer update 命令前删除你磁盘中的依赖文件。

faq/why-are-version-constraints-combining-comparisons-and-wildcards-a-bad-idea.md

@@ -7,6 +7,7 @@
 - `>=2` 表示资源包应该是 2.0.0 或以上版本。
 - `2.*` 表示资源包版本应该介于 2.0.0 （含）和 3.0.0（不含）之间。
 
-正如你所看到的，要同时满足这两个规则包版本必须 >=2.0.0，但它是无法判断的，因为当你这么写的时候，你究竟是想要包含 3.0.0 版本还是不包含？它应该进行匹配吗？因为你定义了 `>=2`，但同时你又限制它为 `2.*`。
+正如你所看到的，要同时满足这两个规则包版本必须 >=2.0.0，但它是无法判断的，因为当你这么写的时候，你究竟是想要包含 3.0.0
+版本还是不包含？它应该进行匹配吗？因为你定义了 `>=2`，但同时你又限制它为 `2.*`。
 
 出于这个原因，Composer 将抛出一个错误，并告诉你这是无效的。想要确切的表达你意思，最简单的方法就是仅使用“比较符”和“通配符”其中的一种来定义约束。

faq/why-can't-composer-load-repositories-recursively.md

@@ -1,13 +1,21 @@
 # 为什么 Composer 不递归加载储存库？
 
-当你使用自定义库时，你可能会碰到问题，因为 Composer 不会递归加载你要求的储存库，所以你必须修改这些储存库中所有的 `composer.json` 文件。
+当你使用自定义库时，你可能会碰到问题，因为 Composer
+不会递归加载你要求的储存库，所以你必须修改这些储存库中所有的 `composer.json` 文件。
 
-在详细说明为什么是这样之前，你需要明白：使用自定义 VCS & 包储存库去尝试某些事情，或者使用你 fork 的一个分支，直到你的 pull request 被合并，等等。你不应该使用它们来跟踪你的私人资源包，关于这点你应该看看 [setting up Satis](../articles/handling-private-packages-with-satis.md) 来为你的公司甚至自己处理私人资源包。
+在详细说明为什么是这样之前，你需要明白：使用自定义 VCS & 包储存库去尝试某些事情，或者使用你 fork 的一个分支，直到你的 pull
+request
+被合并，等等。你不应该使用它们来跟踪你的私人资源包，关于这点你应该看看 [setting up Satis](../articles/handling-private-packages-with-satis.md)
+来为你的公司甚至自己处理私人资源包。
 
 这里有三个途径可以使依赖解析器使用你自定义的储存库：
 
 - 读取根包的存储库，从定义的存储库得到所有的软件包，解析依赖需求。这是目前的状态，它工作得很好，除了有“无法递归的加载储存库”这个限制。
 
-- 读取根包的存储库，同时从定义的 repos 初始化资源包，递归的初始化，根据所有依赖包中定义的 repos，以及这些依赖包所依赖的其它包中定义的 repos，等等，然后再解析依赖需求。这可能可以工作，但会严重影响初始化的速度，因为每读取一个 VCS repos 都需要几秒钟。它可能最终执行失败，因为一个包的不同版本，可能来自一个包资源库中一个相同的包，但来至不同的 dist/source 。这样有太多的可能会出错。
+- 读取根包的存储库，同时从定义的 repos 初始化资源包，递归的初始化，根据所有依赖包中定义的 repos，以及这些依赖包所依赖的其它包中定义的
+  repos，等等，然后再解析依赖需求。这可能可以工作，但会严重影响初始化的速度，因为每读取一个 VCS repos
+  都需要几秒钟。它可能最终执行失败，因为一个包的不同版本，可能来自一个包资源库中一个相同的包，但来至不同的 dist/source
+  。这样有太多的可能会出错。
 
-- 读取根包的存储库，然后读取第一级依赖，接着读取这些依赖包所依赖的其它包，等等，然后再解析依赖需求。这样听起来更有效率，但仍然存在第二种解决方案中的问题。因为加载依赖的储存库并不像听起来那么容易。你需要加载所有可能匹配的依赖包的 repos，而这些包的定义又可能是互相冲突的。
+- 读取根包的存储库，然后读取第一级依赖，接着读取这些依赖包所依赖的其它包，等等，然后再解析依赖需求。这样听起来更有效率，但仍然存在第二种解决方案中的问题。因为加载依赖的储存库并不像听起来那么容易。你需要加载所有可能匹配的依赖包的
+  repos，而这些包的定义又可能是互相冲突的。