I.5 指南惯例

hrs 提交于 2019/06/28 - 23:06 , 周五

假设和先决条件

本指南有以下假设和先决条件:

  • 本指南按主题分类; 有关详细信息请参见第i.3节“组织”。许多主题包括先决条件知识部分,其中列出了其他主题,其中需要内容知识才能理解您正在阅读的主题。还假设了指南中未涉及的一些背景知识; 有关详细信息请参见第i.2节“受众和目标”
  • 许多任务主题列出了站点先决条件,这些任务是您需要在您的站点上完成的任务,然后才能在您正在阅读的主题中执行任务。
  • 站点先决条件的细节与本指南中为农民市场建立站点所使用的场景有关( 有关详细信息请参见第i.6节“指导场景”)。您可以根据自己的方案调整任务,但在确定您的站点是否满足任务的站点先决条件时,还需要记住所做的更改。
  • 对于第3.7节“运行交互式安装程序”之后的所有任务主题,还有一个隐含的先决条件:您必须已在您的站点上安装了内容管理软件,并登录到具有足够权限的用户帐户来执行该任务(例如,在您安装站点时创建的用户帐户,该帐户自动具有完全权限。
  • 如果按顺序阅读所有主题,并在执行任务主题时执行所有步骤(保持登录状态),则在阅读每个主题时,应具备适用于每个主题的背景知识和站点先决条件。
  • 本指南演示了如何使用管理用户界面执行任务,并尽可能使用Drush命令行工具(请参见 第3.2节“概念:其他工具”)。您可以随意使用其他命令行工具,例如Drupal Console(如果查找等效命令),或者仅使用管理界面。

文字约定

本指南的文本中使用了以下约定:

  • URL example.com表示您网站的基本URL。有关如何指明网站内部网址的详细信息,请参阅下面的“导航”部分。
  • 您应该在站点的用户界面中看到的文本以斜体显示,例如:单击“ 保存配置”。这仅适用于来自软件的用户界面中的文本,而不适用于在上一主题中输入的文本。例如,关于编辑主题中,你可能会看到这样的指令:单击编辑关于页的行(编辑将是斜体,但关于不会,因为关于页是以前的主题中创建)。
  • URL,文件名和新引入的术语也以 斜体显示
  • 您应在shell命令行键入的文本以等宽字体类型显示,例如:

    drush cr

  • 在本指南中,word 目录始终用于引用文件目录(有些人更喜欢调用文件夹)。

导航

要执行本指南中的大多数任务主题,您需要导航到站点管理界面中的一个或多个页面。您可能会在说明中看到类似的内容(这在您安装基础软件后会更有意义):

Manage administrative菜单中,导航到 Structure > Taxonomyadmin / structure / taxonomy)。

像这样的导航说明假设您已安装核心工具栏模块,此示例意味着在站点顶部的菜单栏中,您需要单击“ 管理”以显示菜单选项,然后单击“ 结构”,“ 分类 ”和“ 分类”,最后,您将位于包含网址http://example.com/admin/structure/taxonomy的网页上(如果您的网站基本网址为 http://example.com)。

menu

这是另一个例子:

管理管理菜单中,导航到 配置 > 系统 > 基本站点设置 (admin / config / system / site-information)。

在此示例中,单击“ 管理配置”后,您需要找到页面的“ 系统”部分,然后在其中单击“ 基本站点设置”。之后,您最终会访问http://example.com/admin/config/system/site-information

system

另一个注意事项:如果您使用的是标准管理核心Seven主题,则管理界面中的许多“添加”按钮会显示+符号。例如,在admin / content上,“添加新内容”按钮显示为 +添加新内容。但是,这是与主题相关的,并不是按钮上文本的一部分(例如,它不一定会被屏幕阅读器读取),因此在本指南中,惯例是不提及纽扣。

填写表格

本指南中的许多任务主题包括您将填写Web表单的步骤。在大多数情况下,将包含表单的屏幕捕获图像,以及您需要在每个表单字段中输入的值表。例如,您可能会看到一个以这样的方式开始的表格,解释如果导航到Configuration > System > Site informationadmin / config / system / site-information),您将看到的站点信息表单:

字段名称说明示例值

网站详细信息>网站名称

您网站的名称

Anytown农贸市场

要使用此表,在表单中“ 站点详细信息”下的部分中找到标记为“ 站点名称”的字段,然后在此字段中输入站点的名称。的“北京市东城农贸市场”的一个例子网站名称,建议在表中,它涉及到建设一个农贸市场一个网站,你会发现所有通过本指南的情景(见第.6,“指导方案”的细节)。另请注意,在某些表单上,您可能必须单击节标题(如本示例中的“ 网站详细信息”)以展开该节并查找其包含的字段。

归因

Jennifer Hodgdon撰写/编辑。

标签