github Samouczek
Rozpoczęcie pracy z github
Szukaj…
Uwagi
Ta sekcja zawiera przegląd tego, czym jest github i dlaczego deweloper może chcieć go używać.
Powinien również wymieniać wszelkie duże tematy w github i zawierać linki do powiązanych tematów. Ponieważ Dokumentacja dla github jest nowa, może być konieczne utworzenie początkowych wersji tych pokrewnych tematów.
Instalacja lub konfiguracja
GitHub to ogromna kolekcja repozytoriów Git. Innymi słowy, możesz myśleć o GitHub jako o kolekcji wielu projektów!
Tworzenie konta
- Odwiedź główną stronę GitHub tutaj
- Wybierz nazwę użytkownika, wpisz swój adres e-mail i wybierz bezpieczne hasło i jesteś gotowy!
Użyteczne narzędzia
Dla początkujących Git / GitHub zrozumienie, jak działa kontrola wersji, może początkowo być mylące. Istnieje wersja GitHub z GUI, którą można pobrać i używać. GitHub Desktop to tylko to narzędzie.
Tworzenie pierwszego repozytorium
Możesz myśleć o repozytorium jako projekcie. Możesz utworzyć repozytorium online lub offline. Wykonaj poniższe kroki:
online
- Najpierw zaloguj się i przejdź do swojego profilu.
- Przejdź do karty „Repozytoria” u góry strony
- Naciśnij zielony przycisk „Nowy” i jesteś gotowy na dudnienie!
Offline
- Pobierz i zainstaluj git (wybierz używany system operacyjny)
- Po pobraniu i instalacji możesz użyć narzędzia wiersza poleceń lub klienta GUI.
- Po instalacji utwórz konto na github
- W prawym górnym rogu kliknij + i wybierz albo utworzenie nowego repozytorium, albo importowanie istniejącego.
- Jeśli wybierzesz nowy, wpisz nazwę repozytorium i wybierz opcję publiczną lub prywatną.
- Kliknij: Utwórz repozytorium
NB Prywatne repozytoria nie są dostępne dla bezpłatnych użytkowników.
Plik README
Jeśli Twój projekt nie ma pliku README.md, GitHub może przeanalizować plik README.rdoc, aby wyświetlić szczegóły. Jeśli ma oba, użyje README.md, dyskretnie ignorując rdoc.
Plik README może zawierać-
Tytuł Projektu
Opisz krótko swój projekt. Możesz również podać link do strony internetowej projektu, odznaki, informacje o społeczności i dane kontaktowe (np. E-mail, witryna społecznościowa).
Pobieranie
Link do pliku wykonywalnego (plik wykonywalny lub plik minimalny lub instalacyjny). Mogą także znajdować się linki do poprzednich wersji.
Instalacja
Jak można wykorzystać swoją pracę. Może obejmować wymagania wstępne, ustawienia, biblioteki stron trzecich, użytkowanie, przestrogi itp.
Demonstracja
Może zawierać próbkę kodu, plik gif, łącze wideo, a nawet zrzuty ekranu.
Autorski
Nazwiska autorów, dane kontaktowe itp.
Podziękowanie
Lista osób lub społeczności pomogła i zainspirowała podczas projektu
Wnosząc wkład
Instrukcje dotyczące wkładu (tj. Dodania funkcji, zgłoszenia błędu, przesłania poprawki) do projektu. Może zawierać również link do dokumentacji.
Licencja
Daj krótkie wprowadzenie do swojej licencji. Możesz również podać link do strony z licencją.
Plik LICENCJA
GitHub pomaga szybko dodać licencję do repozytorium, jako alternatywę dla dodawania własnego pliku tekstowego / przeceny.
W swoim repozytorium kliknij „Utwórz nowy plik”
Na następnej stronie:
- Wpisz
LICENSE.md
lubLICENSE.txt
jako nazwę pliku nowego pliku. - Chcesz skorzystać z nowego szablonu? pojawi się okno dialogowe.
- Wpisz
Wybierz preferowaną licencję.
Licencja, którą można zobaczyć w szczegółach repozytorium:
Z pytań i odpowiedzi - Jak dodać licencję do istniejącego projektu Github
GitHub Flavored Markdown
GitHub rozszerza składnię Markdown o nowe przydatne funkcje.
nagłówek
# Header1
## Header2
### Header3
#### Header4
##### Header5
###### Header6
H1
===
H2
---
Nacisk
*Italic1* _Italic2_
**Bold1** __Bold2__
***Bold_Italic***
~~Strikethrough~~
Linia pozioma
---
***
___
Lista
unordered list:
* item-1
* sub-item-1
* sub-item-2
- item-2
- sub-item-3
- sub-item-4
+ item-3
+ sub-item-5
+ sub-item-6
ordered list:
1. item-1
1. sub-item-1
2. sub-item-2
2. item-2
1. sub-item-3
2. sub-item-4
3. item-3
Stół
Table Header-1 | Table Header-2 | Table Header-3
:--- | :---: | ---:
Table Data-1 | Table Data-2 | Table Data-3
TD-4 | Td-5 | TD-6
Table Data-7 | Table Data-8 | Table Data-9
Kod
inline code- `int i=0`
block code-
``` C
for(int i=0; i<10; i++){
printf("Hallow World! \n");
}
```
Zacytować
> Stay hungry; stay foolish.
>> Quality is better than quantity.
>>> Life is not fair; get used to it.
Połączyć
https://github.com
[GitHub](https://github.com)
[GitHub](https://github.com "github website")
[GitHub][1]
[1]: https://github.com
Wizerunek
![GitHub Logo](https://assets-cdn.github.com/images/icons/emoji/octocat.png "GitHub")
Listy zadań
- [x] completed item
- [ ] incomplete item
Emoji
:octocat: :+1: :book: :ghost: :bulb: :imp:
W przypadku wszystkich emoji GitHub odwiedź - Ściągawka z emotikonami .
Referencje SHA
Każde odwołanie do skrótu SHA1 zatwierdzenia zostanie przekonwertowane na link do samego zatwierdzenia w GitHub:
e7909ea4fbb162db3f7f543d43c30684a3fb745f
Wyciągnij wniosek i referencje do wydania
Wszelkie odniesienia do żądania ściągnięcia lub problemu będą automatycznie powiązane z tym żądaniem lub problemem.
Można to zrobić, umieszczając znak #
przed numerem wydania / prośbą o pobranie.