mirror of
https://gitea.com/Lydanne/issues-helper.git
synced 2025-08-20 10:46:03 +08:00
38 lines
17 KiB
HTML
38 lines
17 KiB
HTML
<!DOCTYPE html>
|
||
<html>
|
||
<head>
|
||
<meta charset="utf-8" />
|
||
<meta
|
||
name="viewport"
|
||
content="width=device-width, initial-scale=1, maximum-scale=1, minimum-scale=1, user-scalable=no"
|
||
/>
|
||
<link
|
||
rel="shortcut icon"
|
||
type="image/x-icon"
|
||
href="https://avatars1.githubusercontent.com/u/73879334?s=200&v=4"
|
||
/>
|
||
<style>
|
||
.markdown table {
|
||
width: auto !important;
|
||
}
|
||
</style>
|
||
<link rel="stylesheet" href="/issues-helper/umi.1f456e5a.css" />
|
||
<script>
|
||
window.routerBase = "/issues-helper/";
|
||
</script>
|
||
<script>
|
||
//! umi version: 3.3.3
|
||
</script>
|
||
<title>快速开始</title>
|
||
</head>
|
||
<body>
|
||
<div id="root"><div class="__dumi-default-layout" data-route="/guide/start" data-show-sidemenu="true" data-show-slugs="true" data-site-mode="true" data-gapless="false"><div class="__dumi-default-navbar" data-mode="site"><button class="__dumi-default-navbar-toggle"></button><a class="__dumi-default-navbar-logo" style="background-image:url('https://avatars1.githubusercontent.com/u/73879334?s=200&v=4')" href="/issues-helper//">Issue Helper</a><nav><div class="__dumi-default-search"><input type="search" class="__dumi-default-search-input" value=""/><ul></ul></div><span><a aria-current="page" class="active" href="/issues-helper//guide">指 南</a></span><span><a href="/issues-helper//base">基 础</a></span><span><a href="/issues-helper//advanced">进 阶</a></span><span><a href="/issues-helper//changelog">更新日志</a></span><span><a target="_blank" rel="noopener noreferrer" href="https://issues-helper.gitee.io">国内镜像<svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="__dumi-default-external-link-icon"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path><polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg></a></span><span><a target="_blank" rel="noopener noreferrer" href="https://github.com/actions-cool/issues-helper">GitHub<svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="__dumi-default-external-link-icon"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path><polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg></a></span><div class="__dumi-default-locale-select" data-locale-count="2"><a href="/issues-helper//en-US/guide/start">English</a></div></nav></div><div class="__dumi-default-menu" data-mode="site"><div class="__dumi-default-menu-inner"><div class="__dumi-default-menu-header"><a class="__dumi-default-menu-logo" style="background-image:url('https://avatars1.githubusercontent.com/u/73879334?s=200&v=4')" href="/issues-helper//"></a><h1>Issue Helper</h1><p></p></div><div class="__dumi-default-menu-mobile-area"><ul class="__dumi-default-menu-nav-list"><li><a aria-current="page" class="active" href="/issues-helper//guide">指 南</a></li><li><a href="/issues-helper//base">基 础</a></li><li><a href="/issues-helper//advanced">进 阶</a></li><li><a href="/issues-helper//changelog">更新日志</a></li><li><a target="_blank" rel="noopener noreferrer" href="https://issues-helper.gitee.io">国内镜像<svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="__dumi-default-external-link-icon"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path><polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg></a></li><li><a target="_blank" rel="noopener noreferrer" href="https://github.com/actions-cool/issues-helper">GitHub<svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="__dumi-default-external-link-icon"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path><polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg></a></li></ul><div class="__dumi-default-locale-select" data-locale-count="2"><a href="/issues-helper//en-US/guide/start">English</a></div></div><ul class="__dumi-default-menu-list"><li><a target="_blank" rel="noopener noreferrer">🍭 介 绍</a><ul><li><a href="/issues-helper//guide"><span>介 绍</span></a></li><li><a aria-current="page" class="active" href="/issues-helper//guide/start"><span>快速开始</span></a></li></ul></li><li><a href="/issues-helper//guide/ref">🎁 参 考</a></li><li><a href="/issues-helper//guide/faq">💬 FAQ</a></li></ul></div></div><ul role="slug-list" class="__dumi-default-layout-toc"><li title="快速开始" data-depth="2"><a href="/issues-helper//guide/start#快速开始"><span>快速开始</span></a></li><li title="1. 新建 Action" data-depth="3"><a href="/issues-helper//guide/start#1-新建-action"><span>1. 新建 Action</span></a></li><li title="2. 编写 Action" data-depth="3"><a href="/issues-helper//guide/start#2-编写-action"><span>2. 编写 Action</span></a></li><li title="3. 启用 Action" data-depth="3"><a href="/issues-helper//guide/start#3-启用-action"><span>3. 启用 Action</span></a></li></ul><div class="__dumi-default-layout-content"><div class="markdown"><h2 id="快速开始"><a aria-hidden="true" tabindex="-1" href="/issues-helper//guide/start#快速开始"><span class="icon,icon-link"></span></a>快速开始</h2><h3 id="1-新建-action"><a aria-hidden="true" tabindex="-1" href="/issues-helper//guide/start#1-新建-action"><span class="icon,icon-link"></span></a>1. 新建 Action</h3><p>点击仓库的 Actions，若已增加过 Actions，会显示如下界面。</p><p><img src="/issues-helper/static/add-1.5eede08a.jpg" alt=""/></p><p>点击 <code>New workflow</code> 新增。</p><p><img src="/issues-helper/static/add-2.ed31eae2.jpg" alt=""/></p><div class="__dumi-default-alert" type="success">你可以点击 <span class="__dumi-default-badge">set up a workflow yourself</span> 新增一个自定义 action，也可以根据模板来套用新增一个 action。<a target="_blank" rel="noopener noreferrer" href="https://github.com/actions-cool/.github">模板使用<svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="__dumi-default-external-link-icon"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path><polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg></a>。</div><h3 id="2-编写-action"><a aria-hidden="true" tabindex="-1" href="/issues-helper//guide/start#2-编写-action"><span class="icon,icon-link"></span></a>2. 编写 Action</h3><p>Actions 存放地址是固定的，统一为 <code>/.github/workflows/xx.yml</code>。</p><p>下面拿首页的例子详细说明下。对应场景为：当一个 issue 新增 <code>help wanted</code> 标签时，系统会自动进行评论。</p><div class="__dumi-default-code-block"><pre class="prism-code language-yml"><button class="__dumi-default-icon __dumi-default-code-block-copy-btn" data-status="ready"></button><div class="token-line"><span class="token key atrule">name</span><span class="token punctuation">:</span><span class="token plain"> Issue Reply</span></div><div class="token-line"><span class="token plain"></span></div><div class="token-line"><span class="token plain"></span><span class="token key atrule">on</span><span class="token punctuation">:</span><span class="token plain"></span></div><div class="token-line"><span class="token plain"> </span><span class="token key atrule">issues</span><span class="token punctuation">:</span><span class="token plain"></span></div><div class="token-line"><span class="token plain"> </span><span class="token key atrule">types</span><span class="token punctuation">:</span><span class="token plain"> </span><span class="token punctuation">[</span><span class="token plain">labeled</span><span class="token punctuation">]</span><span class="token plain"></span></div><div class="token-line"><span class="token plain"></span></div><div class="token-line"><span class="token plain"></span><span class="token key atrule">jobs</span><span class="token punctuation">:</span><span class="token plain"></span></div><div class="token-line"><span class="token plain"> </span><span class="token key atrule">reply-helper</span><span class="token punctuation">:</span><span class="token plain"></span></div><div class="token-line"><span class="token plain"> </span><span class="token key atrule">runs-on</span><span class="token punctuation">:</span><span class="token plain"> ubuntu</span><span class="token punctuation">-</span><span class="token plain">latest</span></div><div class="token-line"><span class="token plain"> </span><span class="token key atrule">steps</span><span class="token punctuation">:</span><span class="token plain"></span></div><div class="token-line"><span class="token plain"> </span><span class="token punctuation">-</span><span class="token plain"> </span><span class="token key atrule">name</span><span class="token punctuation">:</span><span class="token plain"> help wanted</span></div><div class="token-line"><span class="token plain"> </span><span class="token key atrule">if</span><span class="token punctuation">:</span><span class="token plain"> github.event.label.name == 'help wanted'</span></div><div class="token-line"><span class="token plain"> </span><span class="token key atrule">uses</span><span class="token punctuation">:</span><span class="token plain"> actions</span><span class="token punctuation">-</span><span class="token plain">cool/issues</span><span class="token punctuation">-</span><span class="token plain">helper@v1.2</span></div><div class="token-line"><span class="token plain"> </span><span class="token key atrule">with</span><span class="token punctuation">:</span><span class="token plain"></span></div><div class="token-line"><span class="token plain"> </span><span class="token key atrule">actions</span><span class="token punctuation">:</span><span class="token plain"> </span><span class="token string">'create-comment'</span><span class="token plain"></span></div><div class="token-line"><span class="token plain"> </span><span class="token key atrule">token</span><span class="token punctuation">:</span><span class="token plain"> $</span><span class="token punctuation">{</span><span class="token punctuation">{</span><span class="token plain"> secrets.GITHUB_TOKEN </span><span class="token punctuation">}</span><span class="token punctuation">}</span><span class="token plain"></span></div><div class="token-line"><span class="token plain"> </span><span class="token key atrule">issue-number</span><span class="token punctuation">:</span><span class="token plain"> $</span><span class="token punctuation">{</span><span class="token punctuation">{</span><span class="token plain"> github.event.issue.number </span><span class="token punctuation">}</span><span class="token punctuation">}</span><span class="token plain"></span></div><div class="token-line"><span class="token plain"> </span><span class="token key atrule">body</span><span class="token punctuation">:</span><span class="token plain"> </span><span class="token punctuation">|</span><span class="token scalar string"></span></div><div class="token-line"><span class="token scalar string"> Hello @${{ github.event.issue.user.login }}. We totally like your proposal/feedback, welcome PR。</span><span class="token plain"></span></div><div class="token-line"><span class="token plain"></span></div><div class="token-line"><span class="token plain"> 你好 @$</span><span class="token punctuation">{</span><span class="token punctuation">{</span><span class="token plain"> github.event.issue.user.login </span><span class="token punctuation">}</span><span class="token punctuation">}</span><span class="token plain">，我们完全同意你的提议/反馈，欢迎PR。</span></div><div class="token-line"><span class="token plain"></span></div></pre></div><ul><li><code>YML</code> 语法参考<ul><li><a target="_blank" rel="noopener noreferrer" href="https://docs.github.com/en/free-pro-team@latest/actions/reference/workflow-syntax-for-github-actions#on">GitHub Actions 语法<svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="__dumi-default-external-link-icon"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path><polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg></a></li></ul></li><li><code>name</code>：workflow 名称<ul><li>Actions 流程名称，可根据实际情况自定义</li></ul></li><li><code>on</code>：action 触发条件<ul><li>参考 <a target="_blank" rel="noopener noreferrer" href="https://docs.github.com/en/free-pro-team@latest/actions/reference/events-that-trigger-workflows">工作流触发机制<svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="__dumi-default-external-link-icon"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path><polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg></a></li></ul></li><li><code>uses</code>：使用 actions 名称<ul><li><code>uses: actions-cool/issues-helper@v1.2</code>。版本选择请 <a href="/issues-helper//changelog">参考</a></li></ul></li><li><code>issues-hepler</code> 参数<ul><li><code>actions</code>：使用功能的名称，<strong>必填</strong>。支持多个，需用逗号隔开，如 <code>create-comment,close-issue</code> 表示评论和关闭 issue</li><li><code>token</code>：需拥有 push 权限的人员 token<ul><li>更多 <a href="/issues-helper//guide/ref#-token-%E8%AF%B4%E6%98%8E">参考</a></li></ul></li><li><code>issue-number</code>：传入参数，这里表示当前 issue 的编号。如果你对写法疑惑，可 <a target="_blank" rel="noopener noreferrer" href="https://docs.github.com/en/free-pro-team@latest/actions/reference/context-and-expression-syntax-for-github-actions#github-context">查看<svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="__dumi-default-external-link-icon"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path><polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg></a></li><li><code>body</code>：传入参数，这里表示当前进行评论的内容</li></ul></li></ul><h3 id="3-启用-action"><a aria-hidden="true" tabindex="-1" href="/issues-helper//guide/start#3-启用-action"><span class="icon,icon-link"></span></a>3. 启用 Action</h3><p>当你完成编写完成提交到主分支后，即可自动启用该 workflow，触发条件遵循 <code>on</code> 的定义。</p><p>😏 相信到这里你已经对 <code>如何使用</code> 有了大概的了解，是不是想快点尝试一下。</p><p>下面请在 <a href="/issues-helper//base">基 础</a> 和 <a href="/issues-helper//advanced">进 阶</a> 查看你需要的功能，灵活参考。</p></div><div class="__dumi-default-layout-footer-meta"><a target="_blank" rel="noopener noreferrer" href="https://github.com/actions-cool/issue-helper/edit/main/docs/guide/start.md">在 GitHub 上编辑此页<svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="__dumi-default-external-link-icon"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path><polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg></a><span data-updated-text="最后更新时间：">2020-12-27 2:16:18</span></div></div></div></div>
|
||
<script>
|
||
window.g_useSSR = true;
|
||
window.g_initialProps = {};
|
||
</script>
|
||
|
||
<script src="/issues-helper/umi.ca346101.js"></script>
|
||
</body>
|
||
</html>
|