Diese Website soll Geschichten und Artikel darüber anbieten, wie Dokumente wie Code und Unterricht auf dem Weg gelernt werden können. Sie können auch hier Ihre Geschichte erzählen.
Sie können eine Pull-Anfrage mit dem Fork-and-Pull-Workflow direkt einreichen, um einen Artikel hinzuzufügen, oder dem JustwriteClick/docs-ähnlichen Code-Story-Repo einreichen, wenn Sie eine Frage-und-Antwort-Vorlage befolgen möchten.
Wenn Sie in den build -Zweig drücken, können Sie die Build -Ausgabe mithilfe von Netlify vorschauen. Sie müssen sich bei Netlify anmelden, um die Vorschau -Bereitstellung anzuzeigen.
Drücken in die main erstellt die Ausgabe auf https://www.docslikecode.com mit Netlify. Das Auto Publishing ist als Einstellung in Netlify eingeschaltet. Die Bereitstellung von main wird daher automatisch veröffentlicht.
Thema mit freundlicher Genehmigung von https://mmistakes.github.io/so-simple-theme/
Testen Sie Ihre Ergänzungen und Änderungen an Inhalten, indem Sie einen lokalen Build ausführen.
Auf macOS müssen Sie Brew, Bundler.io und Ruby Version Manager installieren, damit Sie eine bestimmte Version von Ruby verwenden können:
Verwenden Sie Brew, um einen Ruby Version Manager zu installieren.
$ brew install rbenv ruby-build
Fügen Sie RBENV hinzu, um zu verprügeln, damit es jedes Mal lädt, wenn Sie ein Terminal öffnen. Wenn Sie MacOS Catalina verwenden, ist Ihre Profildatei möglicherweise .zshrc .
$ echo 'if which rbenv > /dev/null; then eval "$(rbenv init -)"; fi' >> ~/.bash_profile
oder
$ echo 'if which rbenv > /dev/null; then eval "$(rbenv init -)"; fi' >> ~/.zshrc
Quellen Sie Ihre .bash_profile -Datei. Wenn Sie MacOS Catalina verwenden, ist Ihre Profildatei möglicherweise .zshrc .
$ source ~/.bash_profile
oder
$ source ~/.zshrc
Installieren Sie die erforderliche Ruby -Version:
$ rbenv install 2.7.1
$ rbenv global 2.7.1
$ rbenv version
Im Gegenzug sollten Sie ruby 2.7.1 2.7.1 (set by /Users/username/docslikecode/.ruby-version .
Führen Sie gem install bundle aus, um das Bundler -Edelstein zu installieren, das bei Ruby -Abhängigkeiten hilft.
Führen Sie bundle install wenn Sie sich das erste Mal im docslikecode -Verzeichnis befinden.
Um lokal zu bauen: Sobald Sie die Vorbereitung Ihrer Umgebung abgeschlossen haben, können Sie lokal erstellen und die Website in Ihrem Browser überprüfen.
Führen Sie den Servic -Befehl aus.
$ bundle exec jekyll serve
Verwenden Sie die Serveradress -URL http://127.0.0.1:4000/ in einem Browser, um den Inhalt anzunehmen.
Drücken Sie Ctrl+C im Terminal Servic, um den Server zu stoppen.
Tipp
Lassen Sie das Servic -Terminal offen und laufen. Jedes Mal, wenn Sie Änderungen in einer Datei speichern, regeneriert sie die Site automatisch, sodass Sie die Ausgabe sofort testen können. Die einzige Datei, bei der Änderungen einen Neustart erfordern, ist die Datei_config.yml.