Contentful plus Ruby

Wenn Sie gerne mit Ruby arbeiten, aber noch kein zuverlässiges Content Management System (CMS) gefunden haben und die Auswahlmöglichkeiten Sie enttäuschen, wissen wir, wie Sie sich fühlen. Wir wissen das, weil wir es auch erlebt haben. Deshalb schlagen wir eine neue Lösung vor: eine API-first, technologieunabhängige Content-Plattform, die Sie in Ihren Ruby-Anwendungen verwenden können. In diesem Artikel stellen wir die Vorteile der Verwendung von Contentful und unserer Content-Plattform für Ihr nächstes Ruby-Projekt vor.

Bevor wir fortfahren, ist es wichtig zu klären, was Sie mit Contentful erhalten. Über unsere Content-Plattform können Ihre Entwickler*innen Content mit API-Aufrufen abrufen und Editor*innen eine vertraute Web-App zum Erstellen und Verwalten von Content anbieten. Egal, ob Sie für Wearables, Smartphones oder Web-Apps entwickeln, Ihr Content ist nur einen API-Aufruf entfernt. Und da alles als gehostete Lösung in der Cloud ausgeführt wird, erfordert es weit weniger Wartung als ein herkömmliches Ruby-Content-Management-System. So bleibt Ihnen mehr Zeit, um sich auf die Entwicklung großartiger Anwendungen zu konzentrieren.

Wir bieten SDKs für gängige Programmiersprachen wie JavaScript, PHP und natürlich Ruby an. Diese SDKs sollen Ihnen als Entwickler*in die Arbeit mit Contentful erleichtern und Ihnen einen nahezu sofortigen Zugriff auf unsere APIs und deren Funktionen ermöglichen.

Content Delivery API (CDA)

Die Content Delivery API (CDA) von Contentful ist eine schreibgeschützte API für die Bereitstellung von Content von Contentful an Apps, Websites und andere Medien, der als JSON-Daten und Mediendateien ankommt. Um mit unserem Ruby CDA SDK zu beginnen, haben Sie zwei Möglichkeiten. Installieren Sie den „contentful“-Gem:

Oder fügen Sie ihn in Ihre „Gemfile“ ein:

Sobald er in Ihrer „Gemfile“ ist, können Sie „Bundle install“ ausführen, um Gem und alle Abhängigkeiten zu installieren.

Anschließend können Sie mit dem folgenden Code-Snippet arbeiten, um Content aus Contentful abzurufen:

Und da steckt noch viel mehr dahinter. Wenn Sie tiefer eintauchen möchten, haben wir diesen gesamten Prozess in unserem Tutorial „Erste Schritte“ erklärt.

Content Management API (CMA)

Wir haben auch ein Ruby SDK für die Content Management API (CMA) von Contentful. Dies ist eine Lese-/Schreib-API für die Verwaltung von Content. Sie können die CMA für verschiedene Anwendungsfälle verwenden, einschließlich automatischer Importe aus traditionellen CMS wie WordPress oder Drupal und der Erstellung benutzerdefinierter Bearbeitungserfahrungen.

Auch hier haben Sie zwei Möglichkeiten: Entweder Sie installieren unseren „contentful-management“-Gem wie oben beschrieben oder Sie fügen ihn in Ihre „Gemfile“ ein und führen „bundle install“ aus. Wenn Sie ihn in Ihre „Gemfile“ aufnehmen möchten, besteht der einzige Unterschied darin, was genau Sie hinzufügen:

Sobald dies abgeschlossen ist, können Sie mit dem folgenden Code-Snippet arbeiten, um Content aus Contentful zu verwalten:

Für alle, die mehr erfahren möchten, haben wir auch einen Leitfaden für die ersten Schritte mit der Contentful-CMA und Ruby.

Sie verwenden wahrscheinlich ein Framework für Ihre Ruby-Anwendungen – und das aus gutem Grund. Frameworks ermöglichen eine schnelle Skalierung, die Codewartung ist überschaubarer als bei einfachem Ruby und Sie können Ihre Zeit in die eigentliche Aufgabe anstatt in die unterstützende Technologie investieren. Keine Sorge, wir erklären Ihnen alles. Contentful bietet Integrationen für zwei der beliebtesten Ruby-Frameworks: Rails und Sinatra.

Rails

Ruby on Rails, kurz Rails, ist wohl das beliebteste Ruby-Framework. Es wurde entwickelt, um die Programmierung serverseitiger Webanwendungen mit Ruby problemlos zu gestalten, indem Sie weniger Code schreiben und gleichzeitig mehr erreichen können. Um diese Zusammenarbeit zu erleichtern, haben wir zwei Gems überarbeitet, die den Aufbau von Contentful-basierten Rails-Apps vereinfachen: „contentful_rails“ und „contentful_model“. Diese Gems wurden erstellt, um Ruby-Entwickler*innen in die Lage zu versetzen, Contentful einfach in ihre Rails-Apps zu integrieren. Mehr über So verwenden Sie „contentful_rails“ und „contentful_model“ in Ihren Anwendungen erfahren Sie in unserem Blog. Der beste Weg, um mit Contentful und Rails loszulegen, ist, unser Tutorial zur Verwendung von Contentful mit einer Ruby on Rails-App durchzugehen. Obwohl es nicht die zuvor genannten Gems verwendet, ist es der umfassendste Leitfaden, den es gibt.

Sinatra

Sinatra ist eine DSL, die auch in der Ruby-Community häufig zu finden ist und nach der Philosophie arbeitet, „Webanwendungen in Ruby mit minimalem Aufwand zu erstellen“.Hier bei Contentful lieben wir es, Sinatra zu verwenden, weil es einfach und flexibel ist. Tatsächlich haben wir unsere Beispiel-App damit erstellt. Sie können sie auf GitHub ausprobieren. In dieser App haben wir Contentful mithilfe des Service-Musters integriert. Der Grund dafür war, dass wir dynamisch zwischen den Delivery- und Vorschau-APIs wechseln mussten. Außerdem hatten wir auch einige sehr spezielle Abfragen. Sie können einen Blick darauf in unserer Wrapper-Datei werfen. Außerdem ist diese Zeile aus unserer Datei „courses.rb“ ein Beispiel dafür, wie wir sie verwenden. Wenn Sie nach einem schnellen Weg suchen, um loszulegen, können Sie unser Tutorial zum Erstellen Ihrer eigenen Contentful- und Sinatra-Anwendung heranziehen.

Es ist nicht zu leugnen, dass statische Websites ein Comeback erlebt haben – vor allem, weil nicht jedes Webprojekt einen komplexen technischen Stack benötigt. Manchmal reichen ein paar statische Seiten aus. Deshalb haben wir Contentful-Integrationen für Middleman und Jekyll erstellt, zwei beliebte und Ruby-basierte Generatoren für statische Websites. Jede dieser Integrationen wird in unserem Blogbeitrag „Building static sites with Contentful and Ruby“ ausführlich beschrieben.Wir haben mehrere Tutorials zu Middleman und Jekyll, die Funktionen wie die automatisierten Neuerstellungszyklen und andere Beispiel-Repos zeigen. Darüber hinaus hat einer unserer Ruby-Experten, David Litvak, auf seinem GitHub eine ziemlich umfangreiche Demo von dem, was man mit Contentful und Middleman machen kann. In diesem Projekt ist die wichtigste Datei, auf die Sie achten sollten, die „config.rb “, denn, wie David sagt, ist dies „der Ort, an dem die ganze Magie tatsächlich passiert“.

Wir empfehlen Ihnen, sich Contentful für Ruby anzusehen, um Tutorials, Beispiel-Apps und mehr zu finden. Wenn Sie bereit sind, direkt loszulegen, erstellen Sie ein kostenloses Konto und beginnen Sie noch heute mit unserer Content-Infrastruktur zu arbeiten.