2012-12-24 2 views
20

Ich benutze den 'automatischen Generator' von GitHub Pages, und ich sehe, es erzeugt nur eine einzige index.html und andere Web-Ressourcen.Wie erhalte ich eine mehrseitige Site vom automatischen Generator von GitHub Pages?

Wie funktioniert es, wenn ich eine mehrseitige Website aus anderen Markdown-Dateien erstellen möchte?

+1

Dies ist keine Antwort, aber Sie können gerne [Scriptogr.am] (http://scriptogr.am/) um diese Funktionalität bereitzustellen, wenn Sie Dropbox haben. Für Markdown und Github benötigen Sie einen statischen Site-Generator wie [jekyll] (https://github.com/mojombo/jekyll). Die Art, wie GitHub Pages beschrieben wird, ist ein wenig irreführend. –

Antwort

4

Sie ziehen die generierte Seite, nehmen Änderungen und Ergänzungen vor (einschließlich Hinzufügen neuer Seiten und Links zwischen den Seiten), dann Commit und Push.

Die generierte einzelne Seite hilft Ihnen beim Start. Sie können das Layout duplizieren, um andere ähnlich aussehende Seiten von Hand zu generieren.

Siehe Help.

+2

Das ist schade, dass es nur 'hilft mir zu starten', denn danach muss ich die Arbeit auf meiner Projektseite verdoppeln, um README.md, das Wiki und die Site synchron zu halten.Es kann am Anfang helfen, aber es kann später un-helfen. Liege ich falsch? –

+1

Ich verstehe es nicht. Hoffen Sie, dass alles für Sie synchron bleibt und Inhalte magisch generiert werden? –

+2

Wenn ich viele Quellen für Abschriften in meinem Projekt habe, warum kann ich die Seite nicht mit mehreren Seiten neu erstellen? Nachdem ich etwas an meinem 'Master'-Zweig geändert habe, konnte ich einfach die Gh-Seiten neu generieren, um die Seite automatisch aktualisieren zu lassen. Das ist die Schönheit der Dokumentationsgeneration. Ist es nicht? Und übrigens, sogar für den Anfang, eine einzelne Seite ist eine ziemliche Einschränkung. –

18

Sie können Github erhalten Dateien von .markdown-Dateien zu generieren .html durch die Spitze des .markdown gewährleisten beginnt mit dem ---- Block wie folgt aus:

--- 
title: This will be used as the title-tag of the page head 
--- 

hello 
===== 

**You are here!** 

das hier gefunden: http://xlson.com/2010/11/09/getting-started-with-github-pages.html

2
  • Der automatische Generator von GitHub Pages generiert nur eine Seite.
  • Sie können fügen Sie die neue Datei direkt, github Seite veröffentlicht alle Daten (einschließlich Daten in den Unterordnern) für Sie.
3

Github Seiten verwenden die Jekyll site generator, die für Sie eine beliebige Anzahl von Abschlags-Dateien in HTML Suports Konvertieren und die umgebende Vorlage über eine Layout-Datei anwenden. Siehe Github in der Dokumentation zur Verwendung von Jekyll: https://help.github.com/articles/using-jekyll-with-pages

Der Trick ist, dass Sie download a jekyll template/theme haben und es in Ihrer gh-Seiten Zweig auf eigene Faust (Standard jekyll-Konfiguration), statt nur erlaubt Github Seiten automatisch zu erzeugen, um die eine Datei mit ihren eigenen integrierten Themen.

0

Just gemacht gh-pages-generator - das Dienstprogramm, um Website mit der Navigation aus mehreren Markdown-Dateien mit Links zu generieren.

5

Github erstellt automatisch Seiten für Sie, wenn Sie die Markdown-Datei hinzufügen.

  • index.html - yourname.github.io/project-name/
  • about.md - yourname.github.io/project-name/about
  • foo.md - yourname.github.io/project-name/foo

Getestet dies und arbeiten.

Wenn Sie das in wirklich lustige Sachen zu bekommen - Sie müssen in Jekyll bekommen http://jekyllrb.com/

Verwandte Themen