采用
获取源代码,让它成为您的
Foundation 是公开且自助的。获取仓库、运行它、替换标识与内容、验证,然后部署到属于您的账号。公开仓库是规范的技术来源,本页是通往它的最短诚实路径。
- 使用该软件不需要创建 Foundation 账号,也没有许可费。托管和域名是您自己的成本。
- 这里引用的每份文档都在公开仓库中,与它所描述的代码一起版本化。
- 本页内容无需凭信:仓库只差一次点击。
三种正当的采用方式
Foundation 既不要求 Provelopment,也不要求您独自完成。这是采用者真正会走的三种路径,同等有效。
自己使用
适合有一定技术能力的采用者:获取仓库、在本地运行、配置标识、撰写内容、验证并部署。所需的一切都在公开仓库中,其中没有任何部分依赖 Provelopment。
使用自己的开发者或代理机构
您的部署所修改的一切都在配置、内容和资源中,而不是平台代码,因此任何有能力的前端开发者都能接手,即使从未见过 Foundation。
请 Provelopment 协助
Provelopment 可以提供实施协助、技术支持、服务支持和托管服务。它们与基础分离,完全可选。
三者都不是被推荐的方式:最终得到的网站相同,无论选择哪种,源代码都留在您手中。是否引入协助是一项服务决定,您随时可以做出或改变。
从仓库到可运行网站的路径
这是完整的采用顺序。本页不重复其中任何内容:每个步骤都指明掌握细节的文档,因此本站永远不会成为与仓库说明偏离的第二份副本。
1
查看运行中的网站
从演示开始。将一个演示与本站比较,记录标识、内容、导航和功能组合中哪些发生了变化。您在那里看到的一切都可以在自己的副本中配置。
2
在 GitHub 上了解项目
阅读项目是什么、包含什么、仓库如何组织,并在投入时间之前浏览架构文档。
3
获取源代码
克隆或复刻公开仓库。从第一分钟起,您就拥有处于自己掌控之下的副本:无需注册、申请或等待。
4
在本地运行
安装依赖并启动开发服务器后,初始网站会立即渲染:这是一个可以运行的网站,而不是等待填充的空文件夹。
5
配置标识与站点设置
替换站点配置中的占位标识(URL、名称、标语和描述),然后决定需要哪些可选能力。每项能力都有显式的关闭状态。
6
撰写内容与资源
您的页面和业务内容以 Markdown 与配置的形式放在自己的站点目录中,图形会按角色替换占位素材。
7
按需连接外部服务
只有已启用的能力才需要目标地址:咨询端点、预订目标、地图位置或分析服务商。凭据属于部署环境,绝不写入配置文件。
8
发布前验证
运行仓库文档化的关卡。配置在构建时检查,已启用但未完成的能力会大声失败,而不是假装可用。
9
部署到自己的账号
部署到您掌控的主机,并把您的域名指向它。部署手册记录首次部署、持续集成保护、自定义域名步骤和部署后检查。
10
维护与升级
让副本与仓库保持连接,以便有意识地吸收上游改进。您的配置、内容、字典和资源会在更新后保留,平台代码则被替换。
按真实部署经过的顺序给出十个步骤。确切的命令与设置在仓库中,在那里它们会被评审、版本化,并随代码变化保持正确。
开始之前需要什么
Foundation 是真实的代码库,而不是托管式建站工具,因此采用有诚实的前提。它们都不高,也不涉及您没有选择的服务商。
- 熟悉现代 Web 项目:一个配置文件、Markdown 文件,以及少量终端命令。
- 一个您掌控的托管账号;如果需要自有地址,还需要一个域名。部署手册从头到尾说明 Vercel。
- 您自己的标识、内容和图片,用来替换占位内容。
- 仅在启用需要它的集成时,才需要外部服务账号。
除此之外没有必须项。Foundation 不要求 Provelopment 账号、付费等级、特定托管服务商或特定开发者。
您的网站属于您
Foundation 是软件,网站是您的。是否继续与 Provelopment 合作是一项服务决定,而不是技术绑定。
源代码由您保留
仓库副本就是您的部署。没有激活步骤、许可服务器,也没有运行中的网站所依赖的账号。
部署属于您
您部署到自己的托管账号和域名,部署说明以您的账号为前提,而不是我们的。
开发者的选择属于您
配置、内容和资源都由您修改,因此工作可以交给任何有能力的开发者继续:没有隐性知识,也不依赖当初搭建的人。
服务商的选择属于您
咨询接收、预订、地图路线和分析按站点配置,因此服务商由您选择,而不是继承一套固定组合。
后续工作保持可分离
您或您的代理机构在 Foundation 之上构建的内容位于自己的配置、内容和资源中,因此吸收上游改进时不必舍弃它们。
Foundation 是采用 Apache License 2.0 的开源软件。在遵守许可条款的前提下,您可以对项目自身的代码与文档进行使用、修改、分发和商业利用,包括在自有的专有网站中使用:需保留许可证副本与署名声明,不得歪曲所做修改,并接受软件按现状提供且不含担保。这是版权许可:不授予 Provelopment 名称、标志或品牌的权利,随附的第三方素材保留各自的许可与署名。本段是概述,以许可证正文为准。
随项目提供的第三方商标和图标归各自所有者所有,适用其各自的条款,而不是 Foundation 的许可证。
掌握细节的文档
Foundation 文档与代码一起分发,因此不会与代码脱节。以下每份文档在其主题上都是权威,即使本页本会重复它。
README
项目是什么、如何开始、仓库结构,以及真实的校验命令。
CUSTOMIZING.md
面向下游使用者的指南与完整配置参考,包括区分您与平台各自范畴的对照表。
ARCHITECTURE.md
架构风格、边界、依赖方向与集成模式 —— 从“从未见过 Foundation”到高效工作的最短路径。
BRAND_ASSETS.md
品牌资源替换契约:每个可替换的视觉角色及其替换顺序。
DEPLOYMENT.md
发布运行手册:首次部署、持续集成保护、自定义域名与部署后检查清单。
instruction-manuals/
流程:采用、定制、内容、品牌、校验、部署、升级与排障。
LICENSE
规范使用、修改与再分发的 Apache License 2.0 正文。
如果本页与仓库出现分歧,以仓库为准。本页说明采用的形态,仓库执行它。
如需要,帮助是可用的
Provelopment 可以提供实施协助、技术支持、服务支持和托管服务。它与基础分离,完全可选。
- 采用 Foundation、自行部署并从不联系 Provelopment,是完全成功的结果。
- 软件的任何部分都不依赖 Provelopment,文档或代码也不会被留在付费等级之后。
- 协助与项目分开商定,本站不运营销售或支持渠道。
顺序很重要:先按 Foundation 自身的条款使用它,如需要再考虑协助。
从您所在的位置开始
打开演示,看看完成后的 Foundation 网站;阅读仓库,了解您实际会面对什么;准备好构建时使用手册。