Guide中最强大的主题功能是导入、下载和在本地使用主题的能力。当您对主题进行重大更新或从头构建自己的主题时,这些选项为开发人员提供了简化的工作流程。
在本地构建新主题或更新现有主题的工作流程如下:
开始一个新主题
如果您正在从头开始构建一个全新的主题,请考虑从标准哥本哈根主题的新版本开始。为此,您将添加一个新主题,并将哥本哈根主题的新副本添加到Themes页面。您还可以从开源中获得主题的新版本哥本哈根库在GitHub上。
许多人喜欢从现有的主题开始,并进行重大修改以创建自己的主题。如果你正在改造一个现有的主题,并希望保留一些现有的风格,你可以复制这个主题。
要通过添加新的哥本哈根主题或复制现有主题来启动新主题,请参见为指南添加帮助中心主题.
下载主题
现在你已经准备好从指南下载你的主题了。主题是作为模板、JavaScript、CSS和资产的zip归档文件下载的。这使您能够在Guide之外使用自己的开发工具来处理主题。
要下载主题,请参见下载帮助中心主题.
在本地编辑主题
现在可以使用自己的开发工具在本地机器上开始工作了。
为了避免每次您想要预览更改时都将文件压缩并导入Guide,您可以使用Zendesk应用程序工具(ZAT)在web浏览器中本地预览每个更改。亚博本地预览的目标是使主题开发人员能够使用他们熟悉的工具快速轻松地构建主题。要设置ZAT主题预览,请参见本地预览主题更改.
启动预览模式后,您可以在您最喜欢的文本编辑器中修改主题文件。本地预览具有实时加载功能。您对文件所做的更改将自动刷新预览。从这里,您可以快速更改模板、CSS、JavaScript和资产。
此外,当您将主题下载到本地机器时,最好将其签入您最喜欢的版本控制存储库,例如git、mercurial、SVN等。
您的团队也可以使用GitHub协作开发和维护主题,然后在GitHub的指南中预览或发布它。看到设置与指南主题的GitHub集成.
导入主题
发布您的新主题
当您准备好发布新主题时,只需从工作台的主题菜单中单击publish。
进行其他更新
如果您正在使用git或mercurial等版本控制系统,请继续在本地进行更改,而不是在Guide中进行更改。签入更改并再次将主题导入指南。如果您在Guide中不小心更改了主题,请下载更新的主题并将这些更改签入源代码控制系统。
5个评论
当我预览我的主题通过$zat主题预览并将/start链接粘贴在我的Chrome URL中,我在控制台中收到“被CORS策略阻止”的错误。正如预期的那样,源是我自己的子域URL,它试图获取*myMappedDomain * / hc /活动。,这是一个抛出404错误的URL,据我所知,主题加载试图从一个不存在的页面获取数据。这不是模板中代码的一部分。
我确实允许按a加载混合内容这篇文章,但没有特别提到CORS问题。
虽然在这种情况下我确实使用了ZAT工具,但是故障排除歌珥文章:
作为Apps框架的一部分,后端代理服务器可以通过client.request ()调用。通过设置使用该代理歌珥:假在客户端。请求的设置(注意:false也是设置的默认值)。
没有帮助,因为我有预览Zendesk主题的“特殊情况”,我从指南下载,没有明确的客户端请求在主题文件中。亚博
/谢谢,
迭戈
你好,
我们有歌珥故障排除这一定会帮助你找到解决这个问题的办法。
愿一切都好!
“重要的是:如果你建立一个与GitHub集成在指南中对主题进行任何修改都会破坏GitHub的集成。”
有什么办法可以扭转这种局面吗?
事实证明,唯一的方法是在它中断时再次执行积分。
你好,
我们希望与代码定制帮助中心主题或尝试代码定制主题但失败的人交谈。
如果您想通过30分钟的视频采访分享您的反馈,请注册并在表格末尾回答3个简短的调查问题。我们很乐意听到你的消息!
在这里注册。
期待与您交谈!
Gorka Cardona-Lauridsen
Zendesk Guide高级产品经理亚博
请登录留下评论。