Document redirectTo() on fixture page and page data builders
还没有人认领这个 Issue。
评估
- 难度
- 2/5
- 预计耗时
- 半天
- 新手友好度
- 68/100
- Issue 类型
- 文档
- 描述清晰度
- 基本清楚
- 活跃度
- 活跃
- 技术栈
- markdown, php
调研方向
从 content/4.api/ 下的 fixtures 页面开始，在现有的 $cwa->redirect() 文档旁边，阅读 issue 中的 redirectTo() 示例和行为列表。请以关联的 API bundle PR（#468）为准确认行为，不要凭猜测。完成标准是：页面说明了 redirectTo() 与 redirect() 的区别、有效的目标、失败情况、--append 规则，以及 generate-fixtures 的变更。
由索引模型根据 Issue 内容生成。
描述
API bundle PR: https://github.com/components-web-app/api-components-bundle/pull/468 (fixes components-web-app/api-components-bundle#461)
What to document
The fixture builder has a new method on page and page data builders, redirectTo(routeName). It makes the page's own route redirect to another route, for a URL that is both a page and a redirect. A common case is a home page at / that forwards to a section.
$cwa->page('home', uiComponent: 'Primary', layout: 'main', route: '/', routeName: 'home')
->title('Home')
->redirectTo(routeName: 'graphs');
$cwa->pageData($pageData, template: 'conference', route: '/events')
->redirectTo(routeName: 'cwa-conference');
Points for the fixtures / scaffold page (content/4.api/):
- How it differs from
$cwa->redirect('/old', to: 'about'):redirect()creates a separate route that has no page, whileredirectTo()makes the page's own route redirect. - The target is a route name: any route in the same load, including a
$cwa->redirect()route, or one already in the database. An unknown name fails the load with a message naming the page or page data. - A page or page data with no route of its own (a template,
withoutRoute(), or no title and noroute:) cannot redirect, and the load fails with a message namingredirectTo(). doctrine:fixtures:load --append: the redirect is set only on a route the load creates. A page that already exists, or a route whose path is already in use, keeps the redirect it has.generate-fixturesnow writes->redirectTo(routeName: …)for a page or page data whose route redirects. Before this, it dropped the redirect and reported nothing. A target that is not part of the site is listed under "could not be reproduced".
- 主要语言
- Vue
- 星标
- 0
- 派生
- 0
- PR 合并指标
- 30 天内没有已合并 PR
环境准备
这个项目没有提供开发容器、Dockerfile 或贡献指南，环境需要你自己搭建：先看它的 README，通用步骤见我们的新手贡献指南。
从这里开始
- 先读完整个 Issue，再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库，在一个分支上完成修改。
- 提交 Pull Request，并在描述里引用这个 Issue 编号。
components-web-app/docs 的其他 Issue
-
难度 2/5 1-3 小时 新手友好度 70/100
components-web-app/docs#245 ·
-
难度 2/5 1-3 小时 新手友好度 72/100
components-web-app/docs#243 ·
-
难度 2/5 1-3 小时 新手友好度 68/100
components-web-app/docs#241 ·
-
documentation
难度 5/5 一周以上 新手友好度 15/100
components-web-app/docs#246 ·
-
Document the generate-fixtures asset store (fixtures.assets, $cwa->asset(), prune-fixture-assets)未关闭
难度 3/5 1-2 天 新手友好度 45/100
components-web-app/docs#242 ·
查看 components-web-app/docs 的全部 Issue
相似的 Issue
-
难度 1/5 1-3 小时 新手友好度 75/100
siyuan-note/siyuan#20629 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 72/100
aws-samples/sample-per-model-bedrock#261 ·
维护者通常 1 天内回复
-
难度 1/5 1 小时以内 新手友好度 88/100
-
难度 1/5 1 小时以内 新手友好度 82/100
-
难度 1/5 1 小时以内 新手友好度 88/100
NetAppDocs/ontap#2151 ·