Fossil SCM
Added information on 2FA to the new mirroringtogithub.md doc
Commit
a2ef43104ffee42635e5dc50a5c43a6d7426bd93aedd0ee7eaad8017fc6771a6
Parent
5cb3e0946486682…
1 file changed
+20
-11
+20
-11
| --- www/mirrortogithub.md | ||
| +++ www/mirrortogithub.md | ||
| @@ -15,29 +15,38 @@ | ||
| 15 | 15 | |
| 16 | 16 | <blockquote> |
| 17 | 17 | https://github.com/username/project.git |
| 18 | 18 | </blockquote> |
| 19 | 19 | |
| 20 | -<li><p>Back on your workstation, move to a checkout for your project and | |
| 21 | - type: | |
| 20 | +<li><p>Back on your workstation, move to a checkout for your Fossil | |
| 21 | + project and type: | |
| 22 | 22 | |
| 23 | 23 | <blockquote> |
| 24 | 24 | <pre>$ fossil git export /path/to/git/repo --autopush \ |
| 25 | 25 | https://<font color="orange">username</font>:<font color="red">password</font>@github.com/username/project.git</pre> |
| 26 | 26 | </blockquote> |
| 27 | 27 | |
| 28 | -<p> In place of the <code>/path/to...</code> argument above, put in some | |
| 29 | - directory name that is <i>outside</i> of your Fossil checkout. Fossil | |
| 30 | - will create this directory if necessary. This directory will | |
| 31 | - become a Git repository that holds a translation of your Fossil | |
| 32 | - repository. | |
| 28 | +<p> In place of the <code>/path/to...</code> argument above, put in | |
| 29 | + some directory name that is <i>outside</i> of your Fossil checkout. If | |
| 30 | + you keep multiple Fossil checkouts in a directory of their own, | |
| 31 | + consider using <code>../git-mirror</code> to place the Git export | |
| 32 | + mirror alongside them, for example. Fossil will create this | |
| 33 | + directory if necessary. This directory will become a Git | |
| 34 | + repository that holds a translation of your Fossil repository. | |
| 33 | 35 | |
| 34 | 36 | <p> The <code>--autopush</code> option tells Fossil that you want to |
| 35 | - push the Git translation up to GitHub every time it is updated. Note | |
| 36 | - that you will need to augment the URL supplied by GitHub to insert | |
| 37 | - your account <font color="orange">username</font> and <font | |
| 38 | - color="red">password</font>. | |
| 37 | + push the Git translation up to GitHub every time it is updated. | |
| 38 | + | |
| 39 | +<p> The URL parameter is the same as the one GitHub gave you, but with | |
| 40 | + your GitHub <font color="orange">username</font> and <font | |
| 41 | + color="red">password</font> added. | |
| 42 | + | |
| 43 | +<p> If your GitHub account uses two-factor authentication (2FA), you | |
| 44 | + will have to <a href="https://github.com/settings/tokens">generate | |
| 45 | + a personal access token</a> and use that in place of your actual | |
| 46 | + password in the URL. This token should have “repo” scope enabled, | |
| 47 | + only. | |
| 39 | 48 | |
| 40 | 49 | <p> You can also run the command above outside of any open checkout of |
| 41 | 50 | your project by supplying the “<code>-R repository</code>” |
| 42 | 51 | option. |
| 43 | 52 | |
| 44 | 53 |
| --- www/mirrortogithub.md | |
| +++ www/mirrortogithub.md | |
| @@ -15,29 +15,38 @@ | |
| 15 | |
| 16 | <blockquote> |
| 17 | https://github.com/username/project.git |
| 18 | </blockquote> |
| 19 | |
| 20 | <li><p>Back on your workstation, move to a checkout for your project and |
| 21 | type: |
| 22 | |
| 23 | <blockquote> |
| 24 | <pre>$ fossil git export /path/to/git/repo --autopush \ |
| 25 | https://<font color="orange">username</font>:<font color="red">password</font>@github.com/username/project.git</pre> |
| 26 | </blockquote> |
| 27 | |
| 28 | <p> In place of the <code>/path/to...</code> argument above, put in some |
| 29 | directory name that is <i>outside</i> of your Fossil checkout. Fossil |
| 30 | will create this directory if necessary. This directory will |
| 31 | become a Git repository that holds a translation of your Fossil |
| 32 | repository. |
| 33 | |
| 34 | <p> The <code>--autopush</code> option tells Fossil that you want to |
| 35 | push the Git translation up to GitHub every time it is updated. Note |
| 36 | that you will need to augment the URL supplied by GitHub to insert |
| 37 | your account <font color="orange">username</font> and <font |
| 38 | color="red">password</font>. |
| 39 | |
| 40 | <p> You can also run the command above outside of any open checkout of |
| 41 | your project by supplying the “<code>-R repository</code>” |
| 42 | option. |
| 43 | |
| 44 |
| --- www/mirrortogithub.md | |
| +++ www/mirrortogithub.md | |
| @@ -15,29 +15,38 @@ | |
| 15 | |
| 16 | <blockquote> |
| 17 | https://github.com/username/project.git |
| 18 | </blockquote> |
| 19 | |
| 20 | <li><p>Back on your workstation, move to a checkout for your Fossil |
| 21 | project and type: |
| 22 | |
| 23 | <blockquote> |
| 24 | <pre>$ fossil git export /path/to/git/repo --autopush \ |
| 25 | https://<font color="orange">username</font>:<font color="red">password</font>@github.com/username/project.git</pre> |
| 26 | </blockquote> |
| 27 | |
| 28 | <p> In place of the <code>/path/to...</code> argument above, put in |
| 29 | some directory name that is <i>outside</i> of your Fossil checkout. If |
| 30 | you keep multiple Fossil checkouts in a directory of their own, |
| 31 | consider using <code>../git-mirror</code> to place the Git export |
| 32 | mirror alongside them, for example. Fossil will create this |
| 33 | directory if necessary. This directory will become a Git |
| 34 | repository that holds a translation of your Fossil repository. |
| 35 | |
| 36 | <p> The <code>--autopush</code> option tells Fossil that you want to |
| 37 | push the Git translation up to GitHub every time it is updated. |
| 38 | |
| 39 | <p> The URL parameter is the same as the one GitHub gave you, but with |
| 40 | your GitHub <font color="orange">username</font> and <font |
| 41 | color="red">password</font> added. |
| 42 | |
| 43 | <p> If your GitHub account uses two-factor authentication (2FA), you |
| 44 | will have to <a href="https://github.com/settings/tokens">generate |
| 45 | a personal access token</a> and use that in place of your actual |
| 46 | password in the URL. This token should have “repo” scope enabled, |
| 47 | only. |
| 48 | |
| 49 | <p> You can also run the command above outside of any open checkout of |
| 50 | your project by supplying the “<code>-R repository</code>” |
| 51 | option. |
| 52 | |
| 53 |