GitHub-yň 12 täsin aýratynlygy

Ömrüm üçin hiç hili giriş hakda pikir edip bilemok, şonuň üçin ...

# 1 GitHub.com-da redaktirleme kody

Her kimiň eýýäm bilýän zatlaryndan başlaryn (bir hepde öň bu hakda hiç hili pikirim ýokdy). GitHub-da islendik tekst faýlyny göreniňizde, islendik ammarda sagyň ýokarsynda kiçijik galam görüp bilersiňiz. Eger bassaňyz, bu faýly redaktirläp bilersiňiz. Bir gezek gutaransoň, faýl üýtgetmegi teklip ediň we GitHub çatryk we Pull haýyşyny döreder. Geň galdyryjy, şeýlemi? Çeňňegi özi döredýär! Kody özüňize ýüklemek, ýüklemek, ýerli üýtgeşmeler girizmek we Pull haýyşy bilen GitHub-a ibermek zerurlygy ýok. Minimal redaktirlemeli bolsaňyz gaty amatly. hakyky çekiş haýyşy däl

# 2 Suratlary goýmak

Meseläniň beýany diňe tekst düşündirişleri bilen çäklenmeýär. Suratlary buferden göni goýup biljekdigiňizi bilýärdiňizmi? Goýlanda, onuň ýüklenendigini (buluda, şübhesiz) we şekili görkezmek üçin bellige öwrülendigini görersiňiz. Merhemetli!

# 3 Kod formaty

Bir topar kod ýazmak zerur bolsa, üç sany yzky söz bilen başlaň we GitHub haýsy programmirleme dilini ýazýandygyňyzy çaklamaga synanyşar. Vöne koduň bir bölegini Vue, Typescript ýa-da JSX ýaly programmirleme dilinde ýerleşdirýän bolsaňyz, sintaksis aýratynlygynyň dogry bolmagy üçin dili aç-açan kesgitläp bilersiňiz. Birinji setirdäki "jsx" -e üns beriň: ... kod parçasynyň dogry görkezilmegini üpjün etmek: (Theogsa-da, bu Gist-e hem degişlidir. Bir gysgaça .jsf giňeltmesini görkezseňiz, JSF sintaksis görkeziler). Ine, goldanýan sintaksisleriň sanawy .

# 4 Pull haýyşlarynda “jadyly sözleri” ulanmak bilen ýapylýan meseleler

234-nji meseläni düzedýän Pull haýyşyny döredýärsiňiz diýeliň. "234-nji meseläni düzedýär" tekstini haýyşyňyzyň beýanyna (ýa-da islendik üýtgeşme haýyşy düşündirişiniň islendik ýerine) girizip bilersiňiz. Ondan soň, Pull haýyşyny birleşdirmek meseläni “awtomatiki” ýapar. Salkyn, şeýlemi? Ine, resminamalarda bu barada has giňişleýin maglumat .

# 5 Teswirlere baglanyşyk

Belli bir teswire baglanyşyk döretmeli bolduňyzmy we nädip bilmediňiz? Şol günler uzak geçdi, sebäbi size bir syr bererin: Teswirlere baglanyşyk döretmek üçin, adyň gapdalyndaky senä / wagta basyň. Seret, indi geýronyň suraty bar!

# 6 Kod baglanyşygy

Şonuň üçin belli bir kod setirine baglanyşyk döretmek isleýärsiňiz. Bu ýagdaýda synap görüň: Açyk faýldaky islenýän koduň gapdalyndaky setir belgisine basyň. Wah, görýäňmi? URL üýtgedi, indi setir belgisi görünýär! SHIFT düwmesini basyp, başga setir belgisine bassaňyz, voila! - URL ýene üýtgär we hatarlaryň diapazony görkeziler. Bu URL indi bu faýly we bu setirleri görkezer. Waitöne garaşyň, häzirki sapagy görkezýär. Faýl üýtgese näme etmeli? Bu ýagdaýda faýlyň häzirki ýagdaýyna hemişelik baglanyşyk gerek bolsa gerek. Men gaty ýalta, şonuň üçin ýokardakylaryň bir suratyny aldym: Theeri gelende aýtsak, URL-ler hakda ...

# 7 GitHub URL-ni buýruk setiri hökmünde ulanmak

UI ulanyp, GitHub-da gezmek gaty amatly tertiplidir. Sometimesöne käwagt belli bir ýere barmak üçin ony URL-e ýazmak has çalt bolýar. Mysal üçin, işleýän bir şahamçamyza baryp, onuň ussat bilen deňeşdirilişini görmek islesem, ammar adyndan soň diňe ýazyp / deňeşdirip / şahadatnamasyny ýazyp bilerin. Bu meni şol şahanyň tapawutly sahypasyna alyp barar: Theseöne bular esasy şahadan tapawutlar, ýöne öň integrasiýa bölümi bilen işleşen bolsam, URL-de /compare/integration-branch...my-branch girip bilerin Hotkey söýüjiler üçin: CTRL + L ýa-da CMD + L kursory URL setirine geçirýär (iň bolmanda Chrome we Firefox brauzerlerinde). Bu, brauzeriň awtomatiki tamamlanmagy bilen bilelikde şahalaryň arasynda gezmegi has aňsatlaşdyrýar. Maslahat: Chrome-yň awtomatiki tekliplerinden geçmek üçin oklary ulanyň we taryhdaky zatlary aýyrmak üçin SHIFT + DELETE basyň (mysal üçin, şahany birleşdireniňizden soň). (SHIFT + DELETE ýaly boş ýer goýsam, bu gysga düwmeleri okamak has aňsat bolarmy bilemok. Technöne tehniki taýdan "+" olaryň bir bölegi däl, şonuň üçin bu opsiýany halamok. şuňa meňzeş zatlar sebäpli gije ýatamok, Rhonda.)

# 8 Meseleler üçin sanaw dörediň

Mesele düşündirişiňizde bellik gutusy isleýärsiňizmi? Sanawdan bir meseläni göreniňde “5-den 2” ýaly elli çyzygyň peýda bolmagyny isleýärsiňizmi? Mesele ýok! Aşakdaky sintaksis ulanyp, interaktiw bellikleri döredip bilersiňiz:

• [] Ekranyň ini (bitewi)
• [x] Hyzmat işgärlerine goldaw
• [x] Goldaw alyň
• [] CSS flexbox goldawy
• [] Omörite elementler

Sintaksis: giňişlik, defis, giňişlik, kwadrat ýaýyň açylmagy, boşluk (ýa-da x), kwadrat ýaýyň ýapylmagy, boşluk we käbir sözler. Ondan soň, bu düwmeleri hakykatdanam barlap / aýryp bilersiňiz! Näme üçindir, bu meniň üçin bir hili tehniki jady ýaly bolup görünýär. Gutulary belläp bilersiňiz! Şol bir wagtyň özünde asyl tekst üýtgeýär! Geljekde näme pikir etjekdiklerini pikir etmek gorkunç. Aý, bu mesele taslama panelinde bolsa, öňegidişlik hem şol ýerde görkeziler: "Taslama paneli" diýjek bolýan zadymy düşünmeseňiz - aşakda okaň. Bu sahypada bary-ýogy birnäçe santimetr aşakda.

# 9 GitHub-da taslama panelleri

Uly taslamalar üçin elmydama Jira ulandym. Şahsy taslamalarym üçin bolsa Trello-ny elmydama ulandym. Bu gurallaryň ikisini-de haladym. Birnäçe hepde öň GitHub-yň öz ammaryny, ammaryň Taslamalar goýmasynda hödürländigini eşidenimde , Trelloda eýýäm işleýän meselelerimiň toplumyny köpeltmegiň manysy bar öýdüpdim. Bu ýerde gülkünç zat ýok. Indi GitHub taslamasynda-da şol bir zat: Graduwaş-ýuwaşdan gözleriňiz pes kontrastly surata öwrenişer Çaltlyk üçin ýokardakylaryň hemmesini bellikler hökmünde goşdum, ýagny GitHub meselesi "hakyky" däl. Emma GitHub-da meseläni dolandyrmagyň güýji ammaryň galan bölekleri bilen integrasiýada bolýar - şonuň üçin ammardan bar bolan meseleleri dolandyryş paneline goşmak has gowudyr. Rightokarky sag burçdaky Kartlary goşmak düwmesine basyň we goşmak isleýän zadyňyzy tapyň. Specialörite gözleg sintaksisiniň peýdasy şu ýerde : mysal üçin görnüşi : pr: açyk we islendik açyk Pull haýyşyny panele süýşürip bilersiňiz ýa-da haýsydyr bir ýalňyşlygy düzetmeli bolsaňyz, bellik: bug . Bar bolan bellikleri meselelere öwrüp bilersiňiz. Netijede, bar bolan mesele görnüşinden ony dogry paneldäki taslama goşuň. Şol taslama paneliniň üçburç sanawyna girer, şonuň üçin haýsy sütüni goýjakdygyny saýlap bilersiňiz Haçan-da “ýumuşyň” beýany bu meseläni ýerine ýetirýän kod bilen bir ammarda bolsa, bu örän amatly. Diýmek, indi köp ýyl bäri Jira / Trello / başga ýerlerde yzarlamazdan, kod setirinde git günäkärlemegi we şol setire sebäp bolan meseläniň doly hekaýasyny bilip bilersiňiz. .

Kemçilikler

Soňky üç hepdäniň dowamynda Jiranyň ýerine GitHub-da hemme zady etmek (kiçijik bir taslama, Kanban stili) we ony söýmek bilen synag edýärin. Developmentöne ösüş tizligine we şuňa meňzeşlere dogry baha berilmeli we dogry hasaplanmaly Scrum taslamasy üçin göz öňüne getirip bilemok. Gowy habar, GitHub taslamalarynda "aýratyn aýratynlyklar" gaty az, başga bir ulgama geçmek üçin köp wagt gerek bolmaz. Şonuň üçin synap görüň we näçeräk halaýandygyňyzy görüň. Munuň näderejede möhümdigini bilemok, ýöne ZenHub hakda eşitdim we 10 minut öň ilkinji gezek açdym. Aslynda GitHub-yň giňelmesi, bu ýerde meselelere baha berip, "epiki" we garaşlylygy döredip bilersiňiz. Ösüş tizliginiň we ýadawlygyň grafikleri bar; Bu diňe täsin zat ýaly. Goşmaça okaň: Taslamalar boýunça GitHub resminamalary.

# 10 Gwiki

Wikipediýa ýaly gurulmadyk sahypalar toplumy üçin GitHub Wiki (mundan beýläk Gwiki diýip atlandyraryn) gaty gowy. Düzülen sahypalar toplumy üçin - mysal üçin resminamalaryňyz ýaly - kän däl. “Bu sahypa şol çaganyň çagasydygyny” görkezip bolmaz, “Indiki bölüm” we “Öňki bölüm” düwmeleri ýaly amatly zatlar ýok. Hansel we Gretel bu ýerde hökman ýitirim bolarlar, sebäbi bu ýerde “çörek bölekleri” (ýörite düzediş operatorlary - takmynan trans.) Thereok. . _ _ _ _ ýaşlar bu günler dowzah ýaly duýgur - bu günler ýatýan wagty çagalara okalýan hekaýalar ýeterlik zalym däl!) Geçmek - Gwiki-ni hakyky synap görmek üçin NodeJS-den wiki sahypalary hökmünde birnäçe sahypa girdim, soň adat döretdim sahypanyň hakyky gurluşyny simulirlemek üçin gapdal paneli. Häzirki gapdal sahypa görkezilmese-de, bu gapdal paneli elmydama bar. Salgylar el bilen saklanmaly bolar, ýöne umuman hemme zat gowy işleýär. Isleseňiz, göz aýlap bilersiňiz : Bu, GitBook ( Redux resminamalarynda ulanylýar ) ýa-da kesilen web sahypasy ýaly bir zat bilen bäsleşip bilmez. Thisöne munuň eýýäm 80% -i gowy we ammaryňyzda hemme zat dogry. Men munuň muşdagy. REeke-täk README.md faýlyny ulaldyp, ulanyjy gollanmalary ýa-da has jikme-jik resminamalar üçin birnäçe dürli sahypa gerek bolsa, Gwiki bilen ýapyşmagyň manysy bar. Gurluşyň / nawigasiýanyň ýoklugy sizi biynjalyk edýän bolsa, başga bir zada geçiň.

# 11 GitHub sahypalary

GitHub sahypalarynyň statiki web sahypasyny ýerleşdirmek üçin ulanyp boljakdygyny eýýäm bilip bilersiňiz. Bilmedik bolsaň, indi bilýärsiň. Şeýle-de bolsa, bu bölüm has anyk mowzuga bagyşlanýar: Jekyll- dan web sahypa döretmek. Iň ýönekeý görnüşinde, GitHub Sahypalary + Jekyll, owadan görünýän tema ulanyp, README.md faýlyny görkezip biler. Mysal üçin, github hakda okalýan sahypamyza göz aýlaň : Bu GitHub sahypasynyň sazlamalar goýmasyna bassaňyz, GitHub sahypalaryny açyň we Jekyll mowzugyny saýlaň ... Soňra Jekyll mowzugynyň stilinde bir sahypa alarys : Soňra GitHub-y CMS-e öwürmek bilen, aňsatlyk bilen redaktirläp bolýan bellik faýllaryna esaslanýan tutuş statiki sahypa döredip bilersiňiz. Aslynda muny ulanmadyk bolsam-da, React ulanyp, Bootstrap çarçuwasyny ulanyp web sahypalary şeýle gurulýar, şonuň üçin bu ýerde gorkunç zat ýok. Rubiniň ýerli enjamda işlemelidigini belläp geçýärin (bu ýerdäki Windows ulanyjylary düşünişmek nukdaýnazaryndan pikir alyşarlar we başga ýoldan geçerler, macOS ulanyjylary: “Näme problema, nirä barýarsyňyz? Ruby ähliumumy platforma! Şeýle hem GEMS bar paket dolandyryş ulgamy! ”) (GitHub sahypalarynda" Agressiw ýa-da howp salýan mazmuna ýa-da özüni alyp barşyna "rugsat berilmeýändigini bellemelidiris, şonuň üçin Hansel we Gretel hekaýasynyň wersiýasyny şol ýere goýup bilmersiňiz).

Meniň pikirimçe

GitHub Sahypalary + Jekyll kombinasiýasyna näçe köp göz aýlasam (bu makala üçin), pikiriň hemmesi geň duýulýar. "Iň az tagalla bilen öz web sahypaňyzy ýasamak" pikiri gaty gowy. Itöne üstünde işlemek üçin henizem ýerli enjamda häzirki wersiýa gerek. Şeýle "ýönekeý" bir zat üçin buýruk setiriniň buýruklary gaty köp. Başlamak bölümindäki ýedi sahypany gözden geçirdim we bu hakda ýeke-täk zat özüm ýaly duýdum . Esasy sahypa üçin ýönekeý sintaksis ýa-da ýönekeý “Suwuk dile esaslanýan şablon mehanizmi” esaslaryna-da düşünmedim. Özüm web sahypa ýazsam gowy bolardy! Dogrusyny aýtsam, “Facebook” -yň muny “React” resminamalary üçin ulanýandygyna birneme geň galýaryn, belki-de “React” -i ulanyp, kömek ulgam sahypalaryny gurup we her gün statiki HTML faýllary hökmünde öňünden görkezip bilerler . Bar etmeli zatlary, bar bolan bellik faýllaryny CMS-den gelýän ýaly almagyň ýoluny tapmak. Näme ...

# 12 GitHub-ny CMS hökmünde ulanmak

Käbir tekstli web sahypamyz bar diýeliň, ýöne bu teksti HTML belligi hökmünde saklamak islemeýäris. Munuň ýerine, işlemeýän ulanyjylar tarapyndan aňsatlyk bilen redaktirläp boljak tekst böleklerini bir ýerde saklamak isleýäris. Iň gowusy käbir wersiýa görnüşi bilen. Belki-de, haýsydyr bir deň-duş gözden geçiriş prosesi bilen. Ine, meniň teklip edýän zadym: teksti saklamak üçin ammarda saklanýan bellik faýllaryny ulanyň. Müşderi tarapynda bu tekst böleklerini alyp, sahypada görkezjek komponenti ulanyň. Men “React” -yň muşdagy, şonuň üçin bellik markasyna ýol berilende, ony çykarjak, derňejek we HTML görnüşinde görkezjek dogry “Markdown” komponentiniň mysaly.

class Markdown extends React.Component {
    constructor(props) {
      super(props);

      // Конечно, вам нужно заменить это на свой URL
      this.baseUrl = 'https://raw.githubusercontent.com/davidgilbertson/about-github/master/text-snippets';

      this.state = {
        markdown: '',
      };
    }

    componentDidMount() {
      fetch(`${this.baseUrl}/${this.props.url}`)
        .then(response => response.text())
        .then((markdown) => {
          this.setState({markdown});
        });
    }

    render() {
      return (
        <div dangerouslySetInnerHTML={{__html: marked(this.state.markdown)}} />
      );
    }
}

. _ _ _ _ ( Mazmuny almak üçin GitHub API-den hem peýdalanyp bilersiňiz , ýöne size gerek boljakdygyna şübhelenýärin.) Munuň ýaly komponenti ulanyp bilersiňiz:

const Page = () => (
  <div className="page">
    <div className="about-us">
      <Markdown url="about-us.md" />
    </div>

    <div className="disclaimer">
      <p>A very important disclaimer:</p>

      <Markdown url="disclaimers/home-page-disclaimer.md" />
    </div>
  </div>
);

Şeýlelik bilen, indi GitHub, ýerleşdirmek isleýän tekst bölekleriňiz üçin belli bir derejede CMS-iňizi ýerine ýetirýär. Aboveokardaky mysal diňe komponent brauzere ýüklenenden soň belligi alýar. Statik sahypa gerek bolsa, ony serwerde görkezmeli bolarsyňyz. Gowy täzelik! Serwerdäki ähli bellik faýllaryny almakdan saklaýan hiç zat ýok (islän keş keşbiňizi ulanyp). Bu ugra gitmek kararyna gelseňiz, katalogdaky ähli bellik faýllarynyň sanawyny almak üçin GitHub API-den peýdalanmagyň manysy bar. Bonus - GitHub hyzmatlary! “Octotree Chrome” giňeltmesini eýýäm birnäçe wagt bäri ulanýaryn we size maslahat berýärin. Beýleki şertler bolmazdan, ýöne şonda-da maslahat berýärin. Çep tarapda seredýän ammaryňyzyň agaç görnüşi bilen paneli görkezýär. Bu wideodan oktoboks hakda öwrendim , bu hem şu wagta çenli gaty peýdaly ýaly bolup görünýär. Bu, GitHub meseleleriňiziň gutusy. Ol hakda bilmeli zatlaryň hemmesi. Reňkler barada aýdanymda, sizi gorkuzmazlyk üçin ýokardaky ekran suratlarynyň hemmesini ýeňil mowzukda aldym. Elseöne hemme zatda gara reňkleri has gowy görýän bolsam, näme üçin ölümli reňkli GitHub-a çydamaly? Bu ýerde, Chrome brauzeri (mowzuklary islendik web sahypasyna ulanyp bilýän) we GitHub Dark stili üçin Stylish giňeltmesiniň kombinasiýasyny ulandym . Başlaýanlar üçin GitHub dörediji gurallary garaňky tema (gurlan, diňe işletmeli) we Chrome üçin Atom One Dark mowzugy .

Bitbucket

Gaty aýtsam, bu ýerde düýbünden ýerlikli däl, ýöne Bitbucket hakda aýdyp bilemok. Iki ýyl ozal bir taslama başladym we iň gowy git hostingini saýlamak üçin ýarym gün sarp etdim. Şeýlelikde, “Bitbucket” ep-esli ses bilen ýeňiş gazandy. Olaryň kod gözden geçirijisi bäsdeşlikden has öňde (bu GitHub hatda synçy düşünjesinden has öň bardy). Şondan bäri GitHub hem syn aldy. Gynansagam, soňky ýyl Bitbucket-i ulanmaga mümkinçiligim ýokdy - belki ýene bir zat öňe giden bolmagy mümkin. Şonuň üçin git hosting hyzmatyny saýlamaga jogapkärlere Bitbucket-e hem üns bermegi maslahat berýärin.

Netije

Bu hemmesi! Iň azyndan üç zady size aýdyp bilmedim diýip umyt edýärin. Şeýle hem, makalamy okanyňyzda gowy wagt geçirersiňiz diýip umyt edýärin.