Richten Sie in 5 Minuten einen Jekyll -Blog mit Poole ein

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!