Come pubblicare una pagina Github

Github Pages consente agli sviluppatori di ospitare gratuitamente un sito Web statico del loro progetto. È una delle principali funzionalità di Github che ha reso i progetti open source gratuiti più economici, specialmente per gli sviluppatori indie.

Bootstrap e Normalize.css sono un paio di popolari pagine Github. Per crearne uno, è sufficiente creare un nuovo ramo del repository del progetto e chiamarlo GH-pagine. Pubblica il ramo su Github.

Una volta completato, il sito è accessibile tramite l'URL impostato in base al nome utente Github e al nome del repository. Username .github.io / repository-name.

Puoi configurare un dominio personalizzato per la tua pagina Github. Abbiamo mostrato come farlo nel nostro precedente tutorial.

Github Pages semplificato

Creare una pagina Github è facile e veloce. Ma c'è un piccolo avvertimento.

Prendi uno dei repository demo nel nostro account Github, ad esempio il Calendario dell'Avvento. Abbiamo due rami - maestro e GH-pagine che condividono lo stesso identico ramo del codice.

Dobbiamo assicurarci che i codici in GH-pagine sono sempre sincronizzati con il maestro ramo.

Fortunatamente, Github ha recentemente reso più semplice rimuovendo il GH-pagine requisito di ramo. Ora possiamo alimentare il sito direttamente attraverso il maestro ramo.

Per fare ciò, vai a qualsiasi schermata delle impostazioni del repository Github. Scorri fino alla sezione Github Pages e seleziona il ramo principale menu dalla selezione.

Sei tutto pronto e puoi tranquillamente rimuovere il GH-pagine diramazione dal repository.

Servire documentazione

Alcuni progetti come Bootstrap, Foundation o Skeleton richiedono una pagina di documentazione. E i loro sviluppatori di solito servono anche queste pagine di documentazione attraverso il GH-pagine documento.

Quindi il repository ora ha due rami con un insieme completamente diverso di codici e scopo; uno è il fonte principale, mentre l'altro documentazione dell'ospite e anche alcuni frammenti di codice. In questa situazione, potresti spesso trovare conflitti di cambiamento quando passi da uno di questi due rami all'altro.

Con questo nuovo cambiamento da Github, gli sviluppatori sono ora in grado di servire pagine di documentazione attraverso il nome di una cartella / docs / all'interno del maestro ramo. Quindi, vai su Github Pages e seleziona l'opzione successiva, cartella master / documenti.

Ora, mantenere il codice sorgente e la documentazione è diventato più stremato.