https://wiki.spiralframework.info/history/Tutorial:Using_a_GitHub_Project?feed=atom&Tutorial:Using a GitHub Project - Revision history2024-03-29T05:21:52ZRevision history for this page on the wikiMediaWiki 1.38.4https://wiki.spiralframework.info/w/index.php?title=Tutorial:Using_a_GitHub_Project&diff=313&oldid=prevUnderMybrella at 15:15, 16 April 20182018-04-16T15:15:20Z<p></p>
<table style="background-color: #fff; color: #202122;" data-mw="interface">
<col class="diff-marker" />
<col class="diff-content" />
<col class="diff-marker" />
<col class="diff-content" />
<tr class="diff-title" lang="en-GB">
<td colspan="2" style="background-color: #fff; color: #202122; text-align: center;">← Older revision</td>
<td colspan="2" style="background-color: #fff; color: #202122; text-align: center;">Revision as of 02:15, 17 April 2018</td>
</tr><tr><td colspan="2" class="diff-lineno" id="mw-diff-left-l4">Line 4:</td>
<td colspan="2" class="diff-lineno">Line 4:</td></tr>
<tr><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>GitHub ''does'' require an account to use, however accounts are free for public projects (And private projects won't build).</div></td><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>GitHub ''does'' require an account to use, however accounts are free for public projects (And private projects won't build).</div></td></tr>
<tr><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><br/></td><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><br/></td></tr>
<tr><td class="diff-marker" data-marker="−"></td><td style="color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #ffe49c; vertical-align: top; white-space: pre-wrap;"><div>To get started, you'll need to register an account with [https://github.com GitHub]. After you've gone through the whole confirmation jazz, you're ready to create a new repository over [<del style="font-weight: bold; text-decoration: none;">here </del>https://github.com/new].</div></td><td class="diff-marker" data-marker="+"></td><td style="color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div>To get started, you'll need to register an account with [https://github.com GitHub]. After you've gone through the whole confirmation jazz, you're ready to create a new repository over [https://github.com/new <ins style="font-weight: bold; text-decoration: none;">here</ins>].</div></td></tr>
<tr><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><br/></td><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><br/></td></tr>
<tr><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>In addition, we'll be using the [https://desktop.github.com/ desktop application] for GitHub, as it allows for an easy way to change multiple files, as well as non text files.</div></td><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>In addition, we'll be using the [https://desktop.github.com/ desktop application] for GitHub, as it allows for an easy way to change multiple files, as well as non text files.</div></td></tr>
</table>UnderMybrellahttps://wiki.spiralframework.info/w/index.php?title=Tutorial:Using_a_GitHub_Project&diff=312&oldid=prevUnderMybrella at 04:12, 24 March 20182018-03-24T04:12:38Z<p></p>
<table style="background-color: #fff; color: #202122;" data-mw="interface">
<col class="diff-marker" />
<col class="diff-content" />
<col class="diff-marker" />
<col class="diff-content" />
<tr class="diff-title" lang="en-GB">
<td colspan="2" style="background-color: #fff; color: #202122; text-align: center;">← Older revision</td>
<td colspan="2" style="background-color: #fff; color: #202122; text-align: center;">Revision as of 15:12, 24 March 2018</td>
</tr><tr><td colspan="2" class="diff-lineno" id="mw-diff-left-l52">Line 52:</td>
<td colspan="2" class="diff-lineno">Line 52:</td></tr>
<tr><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>Remember what I mentioned before, too? [[Jenkins]] is able to build your project into an installable mod. </div></td><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>Remember what I mentioned before, too? [[Jenkins]] is able to build your project into an installable mod. </div></td></tr>
<tr><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><br/></td><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><br/></td></tr>
<tr><td class="diff-marker" data-marker="−"></td><td style="color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #ffe49c; vertical-align: top; white-space: pre-wrap;"><div>To do that, you'll need to contact me (UnderMybrella) over Discord, over at <del style="font-weight: bold; text-decoration: none;"><code></del>UnderMybrella#4076<del style="font-weight: bold; text-decoration: none;"></code>, </del>or on the Discord server for SPIRAL [https://discord.gg/BSdvdef here]. If you give me your GitHub repository URL, I'll be able to set up the build for you.</div></td><td class="diff-marker" data-marker="+"></td><td style="color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div>To do that, you'll need to contact me (UnderMybrella) over Discord, over at <ins style="font-weight: bold; text-decoration: none;">"</ins>UnderMybrella#4076<ins style="font-weight: bold; text-decoration: none;">" </ins>or on the Discord server for SPIRAL [https://discord.gg/BSdvdef here]. If you give me your GitHub repository URL, I'll be able to set up the build for you.</div></td></tr>
<tr><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><br/></td><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><br/></td></tr>
<tr><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>[[Category:Tutorials]]</div></td><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>[[Category:Tutorials]]</div></td></tr>
</table>UnderMybrellahttps://wiki.spiralframework.info/w/index.php?title=Tutorial:Using_a_GitHub_Project&diff=311&oldid=prevUnderMybrella: Created page with "So you've started work on a project recently, and you'd like to make it public, open source, and buildable. [https://github.com GitHub] is a great place to host these projects..."2018-03-24T04:12:12Z<p>Created page with "So you've started work on a project recently, and you'd like to make it public, open source, and buildable. [https://github.com GitHub] is a great place to host these projects..."</p>
<p><b>New page</b></p><div>So you've started work on a project recently, and you'd like to make it public, open source, and buildable. [https://github.com GitHub] is a great place to host these projects, in particular because it's easy to set up, easy to maintain, as well as easy for [[Jenkins]] to build.<br />
<br />
==Prerequisite - GitHub account==<br />
GitHub ''does'' require an account to use, however accounts are free for public projects (And private projects won't build).<br />
<br />
To get started, you'll need to register an account with [https://github.com GitHub]. After you've gone through the whole confirmation jazz, you're ready to create a new repository over [here https://github.com/new].<br />
<br />
In addition, we'll be using the [https://desktop.github.com/ desktop application] for GitHub, as it allows for an easy way to change multiple files, as well as non text files.<br />
<br />
{{warning|Please note that your username, repository name, '''''as well as all files that you add to the repository''''' are completely public. Do not put sensitive information in any of them!}}<br />
<br />
==Glossary==<br />
There's a few terms that we'll need to cover real quick.<br />
<br />
A '''repository''' is, essentially, a project. It's where all your files are put, and you can add files as you go.<br />
<br />
A '''branch''' is a separate copy of your project, to be able to edit bits individually. Branches are a good way to keep track of individual, smaller changes, before merging them into the master branch. However, we won't be covering them much in this tutorial, but if you'd like to learn more you can check out [https://guides.github.com/activities/hello-world/ the guide here]<br />
<br />
The '''master''' branch is your primary copy of your project. This is the definitive version of your project, and the one that we'll build with. This will be the only branch we use, for simplicity, however you are able to use other branches as shown above if you'd like to.<br />
<br />
Finally, a '''commit''' is a set of changes that you make to the project. When you '''commit''' a file, it gets added to the project, and any changes are applied.<br />
<br />
==Getting Started==<br />
The first step, if you haven't already, is to create a repository for your project. It's best to use the name of the mod here, but you can use anything you like. In addition, giving it a description serves to highlight what it is, without needing to open it up. Also, clicking "Initialise with README.md" allows you to provide more details about your mod, such as what it does, which games it supports, and so on.<br />
<br />
After you've done this, you'll want to open up GitHub Desktop, and log in. After that's done, clone the repository you created (File > Clone Repository), and choose a space to store it on your computer.<br />
<br />
Once that's done, congratulations! You've taken the first steps to having your project be public.<br />
<br />
==Making Changes==<br />
Now that we have our project, the next step is to make changes, and publish them. <br />
<br />
You're able to structure the directory however you like, add any files you'd like, and GitHub will reflect them once you tell it to.<br />
<br />
So, let's try that then! If you clicked "Initialise with README.md", you'll have one file - README.md. This is a file that is displayed when you visit the project on GitHub, and is useful for giving some information about your project. It's basic text with [https://guides.github.com/features/mastering-markdown/ markdown], so you can use bold and italics here too.<br />
<br />
This will be the first file we change, so let's edit it to just say "Hello, World!" for now.<br />
<br />
Go to the directory that you cloned the repository into, and open the README.md file with any regular text editor. Add "Hello, World!", and save.<br />
<br />
If you go back to GitHub Desktop, it should show that you've changed the file. It'll have a short blurb of changes to the right, as well as all the files you've changed to the left.<br />
<br />
The only thing left to do now, is to write a short summary in the text field that says "Summary", and hit the big "Commit to master".<br />
<br />
However, this won't reflect in the repository online. The reason for this, is that GitHub actually maintains a list of changes on your computer, as well as online. Pressing "Commit to master" changes the local repository, but not the one online. <br />
<br />
To do that, you'll need to press "Push origin" at the top of the window, next to the two buttons that say "Current Repository" and "Current Branch". Once you've done that, it'll take a few moments to upload (or a while, depending on the file sizes and your upload speed). The big advantage of GitHub, is that you only need to upload files that you change, and it only uploads the changes themselves. So if you don't change any of the big files in your project, they won't be uploaded. Neat, huh?<br />
<br />
==Next Steps==<br />
You've done it! Your project is now stored on GitHub, which means people can look at it, and if you ever lose your files locally they're stored there for you to retrieve later.<br />
<br />
Remember what I mentioned before, too? [[Jenkins]] is able to build your project into an installable mod. <br />
<br />
To do that, you'll need to contact me (UnderMybrella) over Discord, over at <code>UnderMybrella#4076</code>, or on the Discord server for SPIRAL [https://discord.gg/BSdvdef here]. If you give me your GitHub repository URL, I'll be able to set up the build for you.<br />
<br />
[[Category:Tutorials]]</div>UnderMybrella