Key Takeaways

• Jekyll, ein statischer Site -Generator, der in Ruby geschrieben wurde, kann verwendet werden, um einfache, verwaltbare Websites oder Blogs zu erstellen, ohne komplexe Datenbanken erforderlich zu machen. Es kann kostenlos auf Github -Seiten gehostet werden.
• Poole, beschrieben als ?Fundamental -Setup“ für Jekyll -Websites, kann verwendet werden, um den Prozess der Einrichtung einer Jekyll -Site zu optimieren. Es kommt mit Beispielvorlagen, Seiten, Beitr?gen und Stilen, um schnell loszulegen.
• Hinzufügen neuer Beitr?ge zu einem Jekyll -Blog beinhaltet die Einstellung einer Markdown -Datei in den Ordner _posts und sicherzustellen, dass sie oben die entsprechende YAML -Frontmaterie enth?lt. Der Blog kann dann über Github -Seiten ver?ffentlicht werden, was ein grundlegendes Verst?ndnis von Git erfordert.

In letzter Zeit gab es in letzter Zeit eine Art Schwung von komplexen, datenbankgesteuerten Websites, die sich zurück in einfachere und statischere Websites befinden-natürlich machbar, beispielsweise mit einer einfachen Portfolio-Website oder einem einfachen Portfolio-Site oder einem Blog.

Das hei?t nicht, dass die Leute zu den .html -Websites von gestern zurückkehren. Sie m?chten weiterhin in der Lage sein, Vorlagen und ortsweite Code effizient verwalten zu k?nnen, und hier kommen statische Site-Generatoren ins Spiel.

statische Site -Generatoren sind so konzipiert, dass sie Ihre verschiedenen statischen Dateien aufnehmen und in eine Website verwandeln. Es gibt viele, viele von ihnen zur Auswahl, und hier auf SitePoint gibt es aktuelle Artikel darüber, die die verschiedenen Sprachen abdecken, in denen sie kommen .

In diesem Artikel werden wir uns Jekyll ansehen, eines der beliebtesten und am h?ufigsten verwendeten. Ich werde beschreiben, wie Sie ein Blog mit minimaler Codierung erstellen und es dann kostenlos auf Github -Seiten hosten k?nnen. Wir werden auch Poole nutzen, eine Art Framework - oder ?Grundlage“ - für den Aufbau von Jekyll -Websites.

Jekyll auf den Punkt

Jekyll ist in Ruby geschrieben. Es ist auf Ihrem Computer als Ruby -Juwel installiert. Es ist kein CMS, es ist keine Blogging -Software, es wird nicht mit Vorlagen, Inhalten usw. geliefert. Es ist viel einfacher als das. Betrachten Sie es als ein einfaches Programm, das praktische M?glichkeiten bietet, Ihre Dateien zu verarbeiten.

Sobald Jekyll installiert ist, k?nnen Sie es aus der Befehlszeile ausführen. Es kann Dinge wie Prozessmarkdown ausführen. Da es eine statische Site generiert, k?nnen Sie den Fortschritt problemlos lokal anzeigen und Ihre Website auf einem statischen Webserver wie GitHub -Seiten hosten.

installieren Sie Jekyll

Zuerst müssen Sie Jekyll in Ihrem System installieren. Führen Sie für Mac den folgenden Befehl im Terminal aus, um Jekyll zu installieren:

$ gem install jekyll

Dies wird automatisch alle Jekyll -Edelsteinabh?ngigkeiten installiert. Wenn Sie w?hrend der Installation stecken bleiben, lesen Sie die Seite Fehlerbehebung auf der offiziellen Website von Jekyll oder stellen Sie ein Problem auf Github ein.

W?hrend Jekyll unter Windows nicht offiziell unterstützt wird, k?nnen Sie es trotzdem mit einigen Verbesserungen ausführen. Weitere Informationen finden Sie auf der Jekyll -Website von Jekyll auf Windows auf der Jekyll -Website oder zu diesem Leitfaden von Julian Thilo.

Poole und Ihren ersten Server erhalten

Verwenden wir Poole, anstatt mit einem rohen Jekyll -Thema zu beginnen. Es wurde von Mark Otto erstellt, und so beschreibt er es:

Poole ist der Butler für Jekyll, den statischen Site -Generator. Es wurde von @MDO entworfen und entwickelt, um ein klares und pr?gnantes, grundlegendes Setup für jede Jekyll -Website zu bieten. Dies geschieht, indem es eine vollst?ndige Vanille -Jekyll -Installation mit Beispielvorlagen, Seiten, Beitr?gen und Stilen bereitstellt.

Sie k?nnen die grundlegende Version hier sehen. Obwohl es für einen minimalen Blog sehr gut ist, mag ich die beiden Themen, die darauf aufgebaut sind: Hyde und Lanyon. Verwenden wir Hyde zum Aufbau unseres Demo -Blogs.

Um das Setup für Hyde zu erhalten, gehen Sie zu seiner Github -Seite und laden Sie das Repository herunter. Legen Sie es in den Ordner Ihrer Wahl und gehen Sie zum Terminal. Nehmen wir an, Sie behalten es auf Ihrem Desktop. Führen Sie die folgenden Befehle aus, um in dieses Verzeichnis zu wechseln und den Server zu starten:

$ gem install jekyll

Der Befehl Jekyll Serve startet einen Entwicklungsserver, mit dem Sie die generierte Site in Ihrem Browser lokal in der Vorschau stellen k?nnen.

Um zu verstehen, was ich meine, ?ffnen Sie eine neue Registerkarte in Ihrem Browser und geben Sie ein: http: // localhost: 4000. Wenn Sie alles richtig verfolgt haben, finden Sie dort Ihr neu geborenes Blog.

neue Beitr?ge addieren

Das von Ihnen gerade heruntergeladene Hyde-Master-Repository enth?lt viele Ordner wie _layouts, _posts und _includes. Es gibt jedoch nur einen Ordner, den Sie sich interessieren müssen, wenn Sie Beitr?ge für Ihr Blog verwalten m?chten: _posts. Es enth?lt alle Ihre Beitr?ge im Markdown -Format.

Platzieren Sie einfach Ihre Markdown -Datei in den Ordner _posts. Stellen Sie sicher, dass Ihre Markdown -Dateien die folgenden (bezeichnet als YAML -Frontmaterial) enthalten:

$ cd Desktop/hyde-master/

$ jekyll serve

Dies zeigt Jekyll, dass Sie einen Beitrag hinzufügen. (überprüfen Sie die Beispielbeitr?ge im Ordner _posts, wenn Sie Zweifel haben.)

Führen Sie Jekyll wieder in Ihrem Terminal aus und Sie finden den neuen Beitrag in Ihrem Blog, wenn Sie http: // localhost: 4000.

?ffnen.

Um das ordnungsgem??e Aufbau Ihres Blogs zu gew?hrleisten, erfordert Jekyll diese Namenskonvention:

---
layout: post
title: Your Post Title
---

Jahr ist eine vierstellige Nummer, Monat und Tag sind zweistellige Nummern, und Markup ist die Dateierweiterung, die das in der Datei verwendete Format darstellt (in unserem Fall MD). Zum Beispiel kann Ihr erster Beitrag 2015-03-29-my-First-Post.md.

bezeichnet werden.

Ver?ffentlichen Sie Ihr Blog

Sobald Sie die obigen Schritte befolgt haben und einige Ihrer eigenen Beitr?ge hinzugefügt haben, sind Sie bereit, Ihr neues Blog der Welt zu zeigen. Sie k?nnen Ihre Dateien an viele Webhosts ver?ffentlichen, aber Github hat es sehr einfach (und kostenlos!) Gemacht, eine statische Jekyll -Site über Github -Seiten zu hosten. Alles, was Sie brauchen, ist ein Github -Konto.

Bevor Sie es nach GitHub drücken, lassen Sie uns einige ?nderungen vornehmen:

In config.yml -Datei:

• Titel, Slogan, Beschreibung GitHub und Autor in Ihre pers?nlichen Daten ?ndern.
• URL in Your_github_username.github.io.
?ndern.

In CNAME erw?hnen Sie Ihre_Github_Uername.github.io anstelle von hyde.getpoole.com. Und bearbeiten Sie über.md, um Ihre Details einzuschlie?en.

Eine, die Sie oben ge?ndert haben, erstellen Sie ein Repository your_github_username.github.io und verschieben Sie alle Dateien von Ihrem Desktop auf dieses Repository.

Versuchen Sie, in einem Browser Ihren neuen Blog zu ?ffnen.

Ein wichtiger Punkt zu beachten: Sie müssen ein wenig Git wissen, um Ihre neuen Beitr?ge zum Repository hinzuzufügen. Wenn die Befehlszeile nicht Ihr Ding ist, gibt es viele Werkzeuge - wie Github für Mac -, die es einfach machen, mit Git zu arbeiten. In jedem Fall kümmern sich GitHub -Seiten, sobald Sie Ihre Beitr?ge zum Repository hinzugefügt haben, den Rest.

Weiteres Lesen

In diesem Beitrag ging es darum, dass Sie mit Jekyll beginnen, aber es gibt viel, was Sie tun k?nnen, wenn Sie bereit sind, etwas Zeit zum Lernen zu verbringen. Sie finden die folgenden Ressourcen nützlich, um Jekyll und Git ein wenig besser zu verstehen:

Jekyll -Dokumentation - sehr ordentlich und bis zur Punktdokumentation
Intro in Jekyll - eine gute Erkl?rung von Johan Ronsee
Grundlagen von Git und GitHub - aus dem offiziellen Github YouTube -Kanal
• Git -Grundlagen in 15 Minuten lernen - ein interaktives Tutorial von Code School.

Ich hoffe, Sie haben diesen Artikel nützlich gefunden. Wenn Sie versuchen, ein Blog mit den oben genannten Schritten zu erstellen und überall festzuhalten, stellen Sie bitte eine Frage in den Kommentaren unten. Ich werde dort aktiv sein.

h?ufig gestellte Fragen (FAQs) zum Einrichten eines Jekyll -Blogs in 5 Minuten mit Poole

Was ist Jekyll und warum sollte ich es für mein Blog verwenden? Ein Vorlagenverzeichnis mit Rohtextdateien in verschiedenen Formaten, führt es über einen Konverter und einen Renderer aus und spuckt eine vollst?ndige, statische, statische Website aus. Der Hauptvorteil der Verwendung von Jekyll ist seine Einfachheit. Es sind keine Datenbanken oder Updates erforderlich, sodass sie sicher und einfach zu warten sind. Au?erdem k?nnen Sie Ihre Website kostenlos direkt auf GitHub hosten.

Was ist Poole und wie erg?nzt sie Jekyll? Es bietet ein klares und pr?gnantes grundlegendes Setup für jede Jekyll -Website. Dies geschieht, indem es eine vollst?ndige Vanille -Jekyll -Installation mit Beispielvorlagen, Seiten, Beitr?gen und Stilen erstellt. Dies hilft Ihnen, in kürzester Zeit mit Jekyll zu fahren.

Wie installiere ich Jekyll und Poole? Sobald Sie Ruby haben, k?nnen Sie Jekyll installieren, indem Sie den Befehls -Gem -Installation Jekyll Bundler ausführen. Für Poole müssen Sie lediglich das Poole -Repository von Github herunterladen oder klonen und loslegen.

Wie erstelle ich einen neuen Beitrag in Jekyll? Jekyll ist unkompliziert. Sie müssen nur eine Datei im Verzeichnis _posts hinzufügen, die der Konvention yyyy-mm-dd-name-of-post.ext folgt, und Jekyll wird sie automatisch in einen Beitrag verarbeiten.

Wie kann ich das Look anpassen und Gefühl meines Jekyll -Blogs? und _Sass -Verzeichnisse. Sie k?nnen auch Ihre eigenen Stylesheets im CSS -Verzeichnis hinzufügen. Sie müssen nur ein neues Repository erstellen, Ihre Jekyll-Site darauf drücken und dann die Repository-Einstellungen so konfigurieren, dass die GH-Seitenzweig für Github-Seiten verwendet wird.

Wie aktualisiere ich mein Jekylll-Blog?

Das Aktualisieren Ihres Jekyll -Blogs ist so einfach, wie ?nderungen an Ihren Dateien vorzunehmen und sie in Ihr Github -Repository zu bringen. Jekyll wird Ihre Website automatisch neu aufbauen, wenn Sie ?nderungen vorantreiben.

Kann ich Jekyll mit anderen Sprachen verwenden? Sie k?nnen die Sprache Ihrer Website in der Datei _config.yml konfigurieren, und Jekyll wird den Rest umgehen.

Wie füge ich meinem Jekyll -Blog Bilder hinzu? Blog, indem Sie sie in das Images -Verzeichnis platzieren und in Ihren Beitr?gen oder Seiten mit der entsprechenden Markdown- oder HTML -Syntax verweisen.

Kann ich Plugins mit verwenden Jekyll?

Ja, Jekyll unterstützt eine Vielzahl von Plugins, die seine Funktionalit?t erweitern k?nnen. Sie k?nnen Plugins installieren, indem Sie sie zu Ihrer Datei gemFile und _config.yml hinzufügen und dann den Befehl bundle install ausführen.

Das obige ist der detaillierte Inhalt vonRichten Sie in 5 Minuten einen Jekyll -Blog mit Poole ein. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!