简短规则
仅共享您希望其他人打开的内容的公共 URL 家庭。请勿共享管理 URLs、编辑 URLs、所有者范围内的内部 URLs 或密码 URLs。公共 URLs 用于项目交接、电子邮件、QR 标签、屏幕截图、印刷材料和搜索索引。
仅当页面或项目在当前状态下可公开访问时,才应复制公共 URL。私人注释、已由关联可跟踪访问控制的注释、私人团队页面、“一次访问可见”可跟踪、“一次访问”可见可跟踪组或内部管理屏幕绝不应复制为公共地址。
公共URL家庭
当您将公共链接复制到电子邮件、帖子、QR 标签或印刷材料中时,请使用短共享 URL。本地化登陆列显示了浏览器应用查看者的语言或直接打开本地化路线系列后人们可能看到的页面外壳。
个人资料页面 URLs 和可见性
与以下人员分享公开资料
/Profile/{userName}.
用户名是该页面系列的稳定路由密钥,当有人尝试打开某人的面向公众的页面时,它可以使复制的链接保持紧凑且易于识别。
访问者打开它后,站点可以在本地化的路由外壳内呈现相同的公共个人资料页面,例如
/{lang}/Profile/{userName}.
配置文件具有三种路由级别可见性状态。私人个人资料意味着只有帐户所有者才能打开个人资料页面。 “我的团队可以查看”意味着所有者和与该用户共享当前团队的登录人员可以打开该团队。公开个人资料意味着任何人都可以直接打开个人资料页面URL。
此设置控制配置文件路径本身。这并不意味着该用户名会从该人已被允许出现的所有其他位置消失,例如笔记所有权、团队花名册或可追踪的所有者标签。
团队页面 URLs 和可见性
将短队 URL 分享为
/team/{teamSlug}.
访问者打开它后,站点可以在本地化的路由 shell 中呈现相同的公共团队页面,例如
/{lang}/team/{teamSlug}.
团队页面要么是公开的,要么仅限团队成员使用。任何人都可以打开公共团队页面,并且可以出现在公共发现界面中。非公开团队页面仍然是有效的工作团队页面,但只有登录的当前团队成员才能打开该路线。
加入策略相关但又独立。团队可以是公开的,但仍然需要管理员批准请求,并且邀请链接仍然是与页面可见性本身不同的访问路径。
注释页 URLs 和可见性
与以下人员共享公共笔记页面
/Note/{noteId}.
然后浏览器可以登陆本地化的公共页面 shell:
/{lang}/Note/{noteId}
同时仍然打开相同的笔记记录。
注释可以是个人范围或团队范围,然后是公开的、私有的或通过这些范围内的关联可跟踪访问进行控制。任何人都可以打开公共个人笔记。私人笔记仅限于所有者。团队笔记可以对所有人公开,也可以保留在团队内部。使用 VisibleOnceAssociatedTrackableAccessed 的注释的行为类似于公共注释,直到附加一个或多个可跟踪项。此后,注释页面仅向已解锁相关可追踪项之一的人员打开。
公共注释页面与源配置文件或团队页面分开。这意味着注释可能仍然有自己的公共路径,而其来源的个人资料页面或团队页面的可见性较窄。请注意,一旦附加一个或多个可跟踪对象,切换到关联可跟踪门控也将停止可公开索引。
可追踪的读取模型还可以在该坐标处显示当前可见的笔记,因此即使附近的笔记后来发生变化,路线也可以保持准确。
当前注释访问仍然遵循注释自身的可见性和所需的访问范围,并且旅程读取可以显示当前在同一坐标处可见的任何注释,而无需将停靠点转变为永久注释所有者。
可跟踪页面 URLs 和可见性
可追踪设备使用公共代码、短密码和长私人扫描令牌的一种进入路线。分享
/trackable/{code},
如果代码是公开的,则站点可以将其解析为呈现的公共页面:
/{lang}/trackable/{publicCode}.
可跟踪的内容可以始终对所有人可见或一旦访问即可可见,无论它们是个人所有还是团队所有。每个人始终可见可跟踪内容可以通过简短的 /trackable/{code} URL 共享,并且任何人都可以打开。访问后可见的可追踪对象不会公开,但密码或 QR 流仍然可以将项目链接到已登录的帐户,以便稍后在将来的登录设备上重新打开。
秘密短代码和仅限 QR 的扫描有效负载不是公开的 URLs。它们是占有凭证。一旦登录帐户成功使用该帐户,该帐户就可以在以后登录的设备上继续重新打开可跟踪项,而无需重新输入密码。团队拥有的可追踪对象仍然对所有人始终可见,而个人拥有的可追踪对象仍然可以在访问后可见。所有权范围和页面可见性是单独的规则。
可跟踪组页面 URLs 和可见性
与以下人员共享始终对所有人可见的群组页面
/trackable-group/{publicCode}.
然后,公共组页面可以在本地化 shell 内呈现:
/{lang}/trackable-group/{publicCode}.
可跟踪组页面还具有页面级可见性规则。每个人始终可见的群组页面可以由任何人打开。访问后可见的群组页面仅限于已具有群组访问权限的登录查看者,包括所有者或团队访问权限以及之前通过群组成员可跟踪之一链接的帐户。
组可见性不会自动强制每个可跟踪成员具有相同的可见性。每个可追踪的成员仍然保留其自己的项目级可见性,并且可能有也可能没有自己的公共页面。访问后可见的成员解锁还可以使相关群组稍后对该登录帐户重新开放,因此一旦您有权访问可跟踪的群组,您也可以重新打开其群组。
类别 URLs
类别没有自己单独的公共 URL 系列。个人类别位于个人资料页面上
/Profile/{userName},
和团队类别位于团队页面上
/team/{teamSlug}.
这使得类别共享易于解释:共享拥有层次结构的页面。
类别管理发生在工作区页面上:
/{lang}/notes
对于个人工作空间和
/{lang}/team/{teamSlug}/workspace/Categories
用于团队工作空间。这些工作区 URLs 是登录管理路由,而不是公共共享 URLs。
为什么 Trackables 保留单一的路线名称
Trackables 在共享 URL 和本地化公共页面中保留单数 /trackable 名词。短共享 URL 保留为 /trackable/{code},因为一条路由可以安全地接受三种不同类型的代码:公共代码、短秘密代码和长私有扫描令牌。
如果代码是公开的,浏览器将被重定向到查看者的特定语言的公共页面:
/{lang}/trackable/{publicCode}.
如果代码是秘密的或仅供扫描,浏览器就会进入拥有流程。这就是为什么短共享 URL 是人们应该复制、打印和通过电子邮件发送的内容,而本地化呈现的页面是访问者在重定向后最终可能看到的内容。
为什么可追踪群组使用一个公共 URL 系列
可跟踪组不需要密码解析器,因此共享 URL 和本地化呈现的页面保持在同一个系列中:
/trackable-group/{publicCode}
本地化为
/{lang}/trackable-group/{publicCode}.
这意味着群组 CTA 始终可以教授一种干净的共享格式,而浏览器仍然停留在观看者的语言外壳上。
永远不应该分享的内容
- 内部工作区 URLs(例如 /en-US/account 或 /en-US/team/{teamSlug}/workspace 是管理路由,而不是公共共享 URLs。
- 秘密代码 URLs 和 QR-仅 URLs 是拥有凭证,而不是公共链接。
- 编辑页面、团队设置、激活页面和内部仪表板等管理路由永远不会公开共享 URLs。
为什么这很重要
人们记住URL模式。如果该网站教导一个简单的家庭,然后悄悄地引导人们通过内部一次性路径,他们就会将错误的内容复制到社交帖子、电子邮件、标签和支持对话中。一个干净的公共 URL 系统可以减少这种混乱并使产品更容易解释。
当同事、客户、教授、同学或印刷的现场材料之间的联系发生变化时,这一点就更重要了。清晰的公共 URL 系列使共享笔记和可跟踪内容更容易传递,而不会暴露错误的页面。
当路线很重要时,同样的清晰度有助于支持将保存的停靠点快照与注释页面本身以及今天碰巧在同一坐标处显示的任何当前可见注释分开。
清晰的公共 URL 家庭还可以更轻松地决定哪些内容可以安全共享,哪些内容应该保密。当公共地址显而易见时,人们就不太可能错误地复制管理页面、私有页面或基于凭据的访问 URL。