git / git/git.github.io

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

Abierto
#830 4 comentarios 0 reacciones 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

Lenguaje dominante
CSS
Estrellas
373
Forks
325
Merge medio
4 d 18 h
PR fusionados (30 d)
1

Descripción

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?

Guía de contribución

No hay ninguna guía de contribución indexada para este repositorio

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Línea de trabajo

Revisa la rama del repositorio y los commits propuestos, empezando por _config.yml y navbar.html; después, inspecciona el sitio de vista previa para comprobar la navegación agrupada, los cambios en las URL y los enlaces añadidos. La tarea estará terminada cuando un maintainer haya tomado una decisión sobre la estructura propuesta y haya confirmado cómo se implementan git-reference y htmldocs sin que se sobrescriban.

Escrito por el modelo de indexación a partir del texto del issue.

Evaluación

Stack tecnológico
css, html, jekyll
Área
documentation, web-dev
Tipo de issue
Nueva funcionalidad
Dificultad
4/5
Tiempo estimado
3-5 días
Estado de actividad
Estancado
Claridad
Necesita aclaración
Aptitud para principiantes
25/100

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.