mirror of
https://github.com/LucasVbr/first-contributions.git
synced 2026-05-13 17:21:50 +00:00
RyanKingWorkrise
152 lines
9.8 KiB
Markdown
152 lines
9.8 KiB
Markdown
[](https://github.com/firstcontributions/open-source-badges)
|
|
[](https://opensource.org/licenses/MIT)
|
|
[](https://www.codetriage.com/roshanjossey/first-contributions)
|
|
|
|
# Tosaíonn Céad Cuireadh
|
|
|
|
Is é aidhm an tionscadail seo a bheith simplí agus treoraithe don tslí a ndéanann túsóirí a gcéad chuimsithe. Más mian leat do chéad chuimsiú a dhéanamh, lean na céimeanna thíos.
|
|
|
|
_Más rud é nach bhfuil tú compordach leis an líne smachta, [tá tutóirialanna anseo ag baint úsáide as uirlisí GUI](#tutorials-using-other-tools)_
|
|
|
|
|
|
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
|
|
|
#### Mura bhfuil git ar do mhaisín agat, [suiteáil é](https://docs.github.com/en/get-started/quickstart/set-up-git).
|
|
|
|
## Foirgneamh an repositry a shábháil
|
|
|
|
Foirgneamh an repositry seo trí ghrúpaigh air a dhéanamh. Cliceáil ar an gcnaipe foirgneamh atá ar bharr an leathanaigh seo. Cruthóidh sé cóip d'an repositry seo in do chuntas féin.
|
|
|
|
|
|
## Clónaigh an repositry
|
|
|
|
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
|
|
|
Anois, clónaigh an repositry ghrúpaithe chuig do mhaisín. Téigh go dtí do chuntas GitHub, oscail an repositry ghrúpaithe, cliceáil ar an gcnaipe cód agus ansin _cliceáil ar an íomhá ghlactha_ chuig an ghluais cóipchlibeaird.
|
|
|
|
|
|
|
|
Oscail tearma agus rith an t-ordú git seo a leanas:
|
|
|
|
```
|
|
git clone "url a ghlac tú amach"
|
|
```
|
|
|
|
Mar sin "url a ghlac tú amach" (gan na tréimhseanna quoitimh) is ea url chuig an repositry seo (do ghruapa den tionscadal seo). Féach ar na céimeanna roimhe sin chun an url a fháil.
|
|
|
|
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
|
|
|
Mar shampla:
|
|
|
|
```
|
|
git clone git@github.com:this-is-you/first-contributions.git
|
|
```
|
|
|
|
Ait a bhfuil `this-is-you` is t-ainm úsáideora GitHub. Anseo atá tú ag cóipeáil ábhar repositry first-contributions ar GitHub chuig do ríomhaire.
|
|
|
|
## Cruthaigh snáth
|
|
|
|
Athraigh go dtí comhad repositry ar do ríomhaire (mura bhfuil tú ansin cheana):
|
|
|
|
```
|
|
cd first-contributions
|
|
```
|
|
|
|
nois cruthaigh snáth ag baint úsáide as an comhad `git switch`:
|
|
|
|
```
|
|
git switch -c your-new-branch-name
|
|
```
|
|
|
|
Mar shampla:
|
|
|
|
```
|
|
git switch -c add-alonzo-church
|
|
```
|
|
|
|
## Déan na hathruithe riachtanacha agus déan comhaireamh orthu
|
|
|
|
Anois, oscail `Contributors.md` i eagarthóir téacs, cuir do ainm leis. Ná cuir é ag tús ná ag deireadh an chomhad. Cuir é in aon áit ina lár. Ansin, sábháil an comhad.
|
|
|
|
|
|
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
|
|
|
Más téann tú go dtí comhaid tionscadail agus déanann tú an t-ordú `git status`, feicfidh tú go bhfuil athruithe ann.
|
|
|
|
Cuir na hathruithe sin leis an snáth a chruthaigh tú leis an gcnaipe `git add`:
|
|
|
|
```
|
|
git add Contributors.md
|
|
```
|
|
|
|
Ansin déan comhaireamh orthu leis an gcnaipe `git commit`:
|
|
|
|
```
|
|
git commit -m "Add your-name to Contributors list"
|
|
```
|
|
|
|
agus cuir in áit do ainm in ionad `your-name`.
|
|
|
|
## Seol athruithe chuig GitHub
|
|
|
|
Seol do chuid athruithe ag baint úsáide as an gcnaipe `git push`:
|
|
|
|
```
|
|
git push -u origin your-branch-name
|
|
```
|
|
|
|
|
|
agus cuir `your-branch-name` do snátha a chruthaigh tú roimhe seo.
|
|
<details>
|
|
<summary> <strong>Má fhaigheann tú botúin ar bith le linn an athsheoladh, cliceáil anseo:</strong> </summary>
|
|
|
|
- ### Authentication Error
|
|
<pre>remote: Support for password authentication was removed on August 13, 2021. Please use a personal access token instead.
|
|
remote: Please see https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ for more information.
|
|
fatal: Authentication failed for 'https://github.com/<your-username>/first-contributions.git/'</pre>
|
|
Go to [GitHub's tutorial](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) on generating and configuring an SSH key to your account.
|
|
|
|
</details>
|
|
|
|
## Cuimhnigh ort do chuid athruithe a chur chun athbhreithnithe
|
|
|
|
Má téann tú go dtí do repositry ar GitHub, feicfidh tú cnaipe `Compare & pull request`. Cliceáil ar an gcnaipe sin.
|
|
|
|
|
|
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
|
|
|
Ansin cuir isteach an iarratas athbhreithnithe.
|
|
|
|
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
|
|
|
Go luath beidh mé ag méascadh na hathruithe uile atá déanta agat isteach i mbranca príomh an tionscadail seo. Beidh ríomhphost fógra agat nuair a bheidh na hathruithe comhoiriúnaithe.
|
|
|
|
|
|
## Cá háit a leantú as seo amach?
|
|
|
|
Comhghairdeas! Chríochnaigh tú an tslí ríthábhachtach _fork -> clone -> edit -> pull request_ iarratas ar athbhreithniú a bhíonn ag tionscalóirí go minic!
|
|
|
|
|
|
Ceiliúraigh do chionta agus roinne é le do chairde agus le do leanúnaigh trí dul go dtí an aip ghréasáin. [web app](https://firstcontributions.github.io/#social-share).
|
|
|
|
D'fhéadfá dul inár bhfoireann Slack má tá cabhair uait nó ceisteanna agat. [Ghabh le foireann Slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1n4y7xnk0-DnLVTaN6U9xLU79H5Hi62w).
|
|
|
|
Anois, lig dúinn tú a thosú ag tacú le tionscadail eile. Tá liosta againn de thionscadail le faidhéideanna éasca a d'fhéadfá tosú orthu. Féach ar liosta na dtionscadal san aip ghréasáin.
|
|
|
|
Anois, lig dúinn tú a thosú ag tacú le tionscadail eile. Tá liosta againn de thionscadail le faidhéideanna éasca a d'fhéadfá tosú orthu. Féach ar [liosta na dtionscadal san aip ghréasáin](https://firstcontributions.github.io/#project-list).
|
|
|
|
### [Ábhar Breise](additional-material/git_workflow_scenarios/additional-material.md)
|
|
|
|
## Tutóirialanna Ag Úsáid Uirlisí Eile
|
|
|
|
| <a href="gui-tool-tutorials/github-desktop-tutorial.md"><img alt="GitHub Desktop" src="https://desktop.github.com/images/desktop-icon.svg" width="100"></a> | <a href="gui-tool-tutorials/github-windows-vs2017-tutorial.md"><img alt="Visual Studio 2017" src="https://upload.wikimedia.org/wikipedia/commons/c/cd/Visual_Studio_2017_Logo.svg" width="100"></a> | <a href="gui-tool-tutorials/gitkraken-tutorial.md"><img alt="GitKraken" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/gitkraken-tutorial/gk-icon.png" width="100"></a> | <a href="gui-tool-tutorials/github-windows-vs-code-tutorial.md"><img alt="VS Code" src="https://upload.wikimedia.org/wikipedia/commons/1/1c/Visual_Studio_Code_1.35_icon.png" width=100></a> | <a href="gui-tool-tutorials/sourcetree-macos-tutorial.md"><img alt="Sourcetree App" src="https://wac-cdn.atlassian.com/dam/jcr:81b15cde-be2e-4f4a-8af7-9436f4a1b431/Sourcetree-icon-blue.svg" width=100></a> | <a href="gui-tool-tutorials/github-windows-intellij-tutorial.md"><img alt="IntelliJ IDEA" src="https://upload.wikimedia.org/wikipedia/commons/thumb/9/9c/IntelliJ_IDEA_Icon.svg/512px-IntelliJ_IDEA_Icon.svg.png" width=100></a> |
|
|
| ----------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
| [GitHub Desktop](gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](gui-tool-tutorials/github-windows-intellij-tutorial.md) |
|
|
|
|
<p>Tugann tacaíocht don tionscadal seo::</p>
|
|
<p>
|
|
<a href="https://www.digitalocean.com/">
|
|
<img src="https://opensource.nyc3.cdn.digitaloceanspaces.com/attribution/assets/SVG/DO_Logo_horizontal_blue.svg" width="201px">
|
|
</a>
|
|
</p>
|