läuft Jekyll lokal auf einem Github-Seiten-Site-Projekt

Question

Ich möchte eine Projekt-Website-Dokumentation erstellen (kein Blog). Ich erstelle eine "Projektseite" github Seite, wie in https://pages.github.com erklärt, und wähle das Thema 'jekyll-theme-cayman'.

Wenn ich jedoch die Datei index.md im Github-Editor bearbeite, sieht die Vorschau anders aus als die Ausgabe in meiner github-Seite (erstellt von jekyll). Ich habe nur zwei Dateien: _config.yml mit dem Inhalt:

theme: jekyll-theme-cayman 

und index.md mit dem Inhalt:

# test 
this url is not automatically auto-linked: http://example.com 

ich jekyll in meinem Computer installiert, aber es funktioniert nicht wie folgt beim Versuch, die Ausgabe zu erzeugen für Meine Projektseite:

$ gem install jekyll bundler 
$ bundle exec jekyll serve 
Configuration file: /private/tmp/test/_config.yml 
jekyll 3.6.2 | Error: The jekyll-theme-cayman theme could not be found. 

Wie kann ich das lösen?

Auch der Text http://example.com wird standardmäßig im Github-Editor automatisch verknüpft, aber nicht in der Jekyll-Ausgabe. Ich las this documentation, und ich versuchte, mit dieser _config.yml, aber es funktioniert nicht:

theme: jekyll-theme-cayman 
markdown: kramdown 
kramdown: 
    autolink: true 

Wie kann ich Auto-Link?

Auch das Thema 'jekyll-theme-cayman' hat einen sehr hohen Header. Wie kann ich das Thema konfigurieren? erlaubt dieses Thema, den Header zu ändern? Wo kann ich den Code des Themas finden und Änderungen vornehmen?

Answer 1

Verwenden Sie die GitHub-Seiten Thema (wird es andere Probleme vermeiden und enthält bereits die Kaiman-Thema), Gemfile sollte wie folgt aussehen:

source "https://rubygems.org" 

gem "github-pages" 

Dann: bundle install und bunle exec jekyll s.

Um das Thema Folge Thema Vorschlag anpassen:

Wenn Sie das Thema des HTML-Layout ändern möchten:

Copy the original template from the theme's repository 
(Pro-tip: click "raw" to make copying easier) 
Create a file called /_layouts/default.html in your site 
Paste the default layout content copied in the first step 
Customize the layout as you'd like 

Autolinks

Autolinks in kramdown sollen zu Umgeben von < und > wie:

<http://example.com> 

<https://example.com> 

Das würde den HTML-Anker-Link erzeugen.