跳到主要内容

采用

获取源代码,让它成为您的

Foundation 是公开且自助的。获取仓库、运行它、替换标识与内容、验证,然后部署到属于您的账号。公开仓库是规范的技术来源,本页是通往它的最短诚实路径。

  • 使用该软件不需要创建 Foundation 账号,也没有许可费。托管和域名是您自己的成本。
  • 这里引用的每份文档都在公开仓库中,与它所描述的代码一起版本化。
  • 本页内容无需凭信:仓库只差一次点击。

三种正当的采用方式

Foundation 既不要求 Provelopment,也不要求您独自完成。这是采用者真正会走的三种路径,同等有效。

  • 自己使用

    适合有一定技术能力的采用者:获取仓库、在本地运行、配置标识、撰写内容、验证并部署。所需的一切都在公开仓库中,其中没有任何部分依赖 Provelopment。

  • 使用自己的开发者或代理机构

    您的部署所修改的一切都在配置、内容和资源中,而不是平台代码,因此任何有能力的前端开发者都能接手,即使从未见过 Foundation。

  • 请 Provelopment 协助

    Provelopment 可以提供实施协助、技术支持、服务支持和托管服务。它们与基础分离,完全可选。

三者都不是被推荐的方式:最终得到的网站相同,无论选择哪种,源代码都留在您手中。是否引入协助是一项服务决定,您随时可以做出或改变。

从仓库到可运行网站的路径

这是完整的采用顺序。本页不重复其中任何内容:每个步骤都指明掌握细节的文档,因此本站永远不会成为与仓库说明偏离的第二份副本。

  1. 1

    查看运行中的网站

    从演示开始。将一个演示与本站比较,记录标识、内容、导航和功能组合中哪些发生了变化。您在那里看到的一切都可以在自己的副本中配置。

    打开演示

  2. 2

    在 GitHub 上了解项目

    阅读项目是什么、包含什么、仓库如何组织,并在投入时间之前浏览架构文档。

    README

  3. 3

    获取源代码

    克隆或复刻公开仓库。从第一分钟起,您就拥有处于自己掌控之下的副本:无需注册、申请或等待。

    采用手册

  4. 4

    在本地运行

    安装依赖并启动开发服务器后,初始网站会立即渲染:这是一个可以运行的网站,而不是等待填充的空文件夹。

    README › 快速开始

  5. 5

    配置标识与站点设置

    替换站点配置中的占位标识(URL、名称、标语和描述),然后决定需要哪些可选能力。每项能力都有显式的关闭状态。

    定制 Foundation

  6. 6

    撰写内容与资源

    您的页面和业务内容以 Markdown 与配置的形式放在自己的站点目录中,图形会按角色替换占位素材。

    内容管理

  7. 7

    按需连接外部服务

    只有已启用的能力才需要目标地址:咨询端点、预订目标、地图位置或分析服务商。凭据属于部署环境,绝不写入配置文件。

    站点定制

  8. 8

    发布前验证

    运行仓库文档化的关卡。配置在构建时检查,已启用但未完成的能力会大声失败,而不是假装可用。

    校验手册

  9. 9

    部署到自己的账号

    部署到您掌控的主机,并把您的域名指向它。部署手册记录首次部署、持续集成保护、自定义域名步骤和部署后检查。

    部署手册

  10. 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 网站;阅读仓库,了解您实际会面对什么;准备好构建时使用手册。