git / git/git.github.io

Test website: Grouping in navigation bar, relative/absoulte URLs and links to Git Reference and HTML docs

Aperta
#830 4 commenti 0 reazioni 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

Lingua principale
CSS
Stelle
373
Fork
325
Merge medio
4g 18h
PR unite (30g)
1

Descrizione

Hello.
This is a presentation (and request for comments) of test version of https://git.github.io with 3 separate features:

  • link grouping in left navigation bar
  • using relative/absolute URLs to git.github.io
  • links to "Git Reference" and "Git HTML docs"

Preview site: https://muxajibi4.github.io/git.github.io/

Repo: https://github.com/MuxaJIbI4/git.github.io on branch 'master'

1. Link grouping in navigation bar

see MuxaJIbI4/git.github.io@da0819c

This is done by moving all pages (except /rev_news) to new /links folder and subfolder inside determines page's group (defined using scope in _config.yml). Then in navbar.html we show groups titles followed by that group pages. Ordering of groups determined by array nb-order in _config.yml. This approach allows not assign group to each page inside 'front matter'.
Also pages inside one group can be ordered using 'order:' property inside pages of the group.
Also although some pages are moved into /links/* folders their links are not changed because of permalink: option in _config.yml.

Group titles and ordering, assigning group to pages, changed page titles, names of /links folder and subfolders are given only as an example

2. Using relative/absolute URLs to git.github.io

see MuxaJIbI4/git.github.io@135a957

This removes hard-coded domain name from subpages.
Removed only in some files - didn't touch /_posts and /links.
Also did not change direct links to /images folder in /_posts and /links.

3. Links to "Git Reference" and "Git HTML docs"

see MuxaJIbI4/git.github.io@b010429

There are 2 additional websites on git.github.io that don't have any links to them (you can find out about them only from outside sources):
https://git.github.io/git-reference - Git Reference
https://git.github.io/htmldocs - Git HTML docs

So I decided to add them to Navigation bar and to the Main page.
On test website link don't work since they are external websites, but URL itself should be correct.

Question: Can somebody tell how do these 2 websites are being deployed and not being overwritten by deployment of git.github.io?

Guida per i contributori

Nessuna guida per i contributori indicizzata per questo repository

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Direzione di ricerca

Esamina il branch del repository e i commit proposti, iniziando da _config.yml e navbar.html, quindi ispeziona il sito di anteprima per la navigazione raggruppata, le modifiche agli URL e i link aggiunti. L’attività è completata quando un maintainer ha preso una decisione sulla struttura proposta e ha confermato come vengono distribuiti git-reference e htmldocs senza essere sovrascritti.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Valutazione

Stack tecnologico
css, html, jekyll
Ambito
documentation, web-dev
Tipo di issue
Funzionalità
Difficoltà
4/5
Tempo stimato
3-5 giorni
Stato di attività
Ferma
Chiarezza
Da chiarire
Idoneità per principianti
25/100

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.