diff --git a/docs/2022/09/20/how-to-create-githubpage.html b/docs/2022/09/20/how-to-create-githubpage.html index 0bd2150..4ce8543 100644 --- a/docs/2022/09/20/how-to-create-githubpage.html +++ b/docs/2022/09/20/how-to-create-githubpage.html @@ -76,8 +76,9 @@ gem "github-pages", "~> GITHUB-PAGES-VERSION", group: :jekyll_plugins
You can find the actual version of GitHub-pages here.
Now save and close the Gemfile.
-
- + +
+

Install bundle

Now still being at the localDev-directory, install the bundle:
$ bundle install
@@ -98,9 +99,13 @@ $ JEKYLL_ENV=production bundle exec jekyll build
Your Jekyll-project was now build and stored at _site.
+ Clear your docs-directory: +
+ $ rm -r ../docs/* +
Now move the content of the localDev/_site to docs:
- $ cp -r _site/* ../docs
+ $ cp -r _site/* ../docs
And push your changes to your central GitHub-Repository.
diff --git a/docs/feed.xml b/docs/feed.xml index f78f889..902c375 100644 --- a/docs/feed.xml +++ b/docs/feed.xml @@ -1,4 +1,4 @@ -Jekyll2022-09-21T15:34:38+02:00/feed.xmlMr.Write an awesome description for your new site here. You can edit this line in _config.yml. It will appear in your document head meta (for Google search results) and in your feed.xml site description.2022 Week 38 How to create a static website with Jekyll and deploy it on GitHubPages2022-09-20T00:00:00+02:002022-09-20T00:00:00+02:00/2022/09/20/how-to-create-githubpage<div class="outerDiv"> +Jekyll2022-09-21T15:41:50+02:00/feed.xmlMr.Write an awesome description for your new site here. You can edit this line in _config.yml. It will appear in your document head meta (for Google search results) and in your feed.xml site description.2022 Week 38 How to create a static website with Jekyll and deploy it on GitHubPages2022-09-20T00:00:00+02:002022-09-20T00:00:00+02:00/2022/09/20/how-to-create-githubpage<div class="outerDiv"> <div id="prerequisits"> <h3>Prerequisits</h3> Install <a href="https://git-scm.com/downloads" target="_blank">Git</a><br> @@ -57,8 +57,9 @@ <i>gem "github-pages", "~> GITHUB-PAGES-VERSION", group: :jekyll_plugins</i><br> You can find the actual version of GitHub-pages <a href="https://rubygems.org/gems/github-pages" target="_blank">here</a>.<br> Now save and close the Gemfile.<br> - <br> - + </div> + <div> + <h3>Install bundle</h3> Now still being at the localDev-directory, install the bundle:<br> <div class="console"> <code>$ bundle install</code><br> @@ -79,9 +80,13 @@ <code>$ JEKYLL_ENV=production bundle exec jekyll build</code> </div> Your Jekyll-project was now build and stored at _site.<br> + Clear your docs-directory: + <div class="console"> + <code>$ rm -r ../docs/*</code> + </div> Now move the content of the localDev/_site to docs:<br> <div class="console"> - <code>$ cp -r _site/* ../docs</code><br> + <code>$ cp -r _site/* ../docs</code> </div> And push your changes to your central GitHub-Repository. </div> @@ -107,4 +112,4 @@ <li><a href="https://jekyllrb.com/docs/step-by-step/10-deployment/" target="_blank">https://jekyllrb.com/docs/step-by-step/10-deployment/</a></li> </ul> </div> -</div>AaronPrerequisits Install Git Install Ruby Install Jekyll and Bundler $ gem install jekyll bundler GitHub Create a GitHub-account Create a repository on GitHub (It has to be public if you use GitHub Free, note that your code will be visible to everyone!) Local Repository Clone the repository to a local directory: ssh $ git clone --recursive SSH_URL https $ git -c http.sslVerify=false clone --recursive HTTPS_URL Directories Create two directories: docs and localDev. $ mkdir docs $ mkdir localDev docs will contain the content of the website later on. localDev will contain our Jekyll project. Create Jekyll Project Move to the localDev-directory: $ cd localDev Create a new Jekyll-project at localDev-directory: $ jekyll new --skip-bundle . (make sure you got the dot) Edit Gemfile Open the Gemfile that Jekyll created and comment out (#) the line which starts with gem "jekyll" Add the github-pages gem by editing the line starting with # gem "github-pages". Change this line (# gem "github-pages") to: gem "github-pages", "~> GITHUB-PAGES-VERSION", group: :jekyll_plugins You can find the actual version of GitHub-pages here. Now save and close the Gemfile. \ No newline at end of file +</div>AaronPrerequisits Install Git Install Ruby Install Jekyll and Bundler $ gem install jekyll bundler GitHub Create a GitHub-account Create a repository on GitHub (It has to be public if you use GitHub Free, note that your code will be visible to everyone!) Local Repository Clone the repository to a local directory: ssh $ git clone --recursive SSH_URL https $ git -c http.sslVerify=false clone --recursive HTTPS_URL Directories Create two directories: docs and localDev. $ mkdir docs $ mkdir localDev docs will contain the content of the website later on. localDev will contain our Jekyll project. Create Jekyll Project Move to the localDev-directory: $ cd localDev Create a new Jekyll-project at localDev-directory: $ jekyll new --skip-bundle . (make sure you got the dot) Edit Gemfile Open the Gemfile that Jekyll created and comment out (#) the line which starts with gem "jekyll" Add the github-pages gem by editing the line starting with # gem "github-pages". Change this line (# gem "github-pages") to: gem "github-pages", "~> GITHUB-PAGES-VERSION", group: :jekyll_plugins You can find the actual version of GitHub-pages here. Now save and close the Gemfile. Install bundle Now still being at the localDev-directory, install the bundle: $ bundle install Optionally you can make changes at the _config.yml file. Learn Jekyll Follow this guide to learn Jekyll. Make sure that all files and directories you create are in the localDev-directory. Note that building locally will not work according to commenting out gem "Jekyll" at the Gemfile. (Atm I didn't check if this is right) If it is, you have to not comment it out and do bundle install again. Afterwards you can test locally with jekyll serve. Build Project After creating all necessary files and dirs, you can make a production build: Note that all files at _site will be cleared! $ JEKYLL_ENV=production bundle exec jekyll build Your Jekyll-project was now build and stored at _site. Clear your docs-directory: $ rm -r ../docs/* Now move the content of the localDev/_site to docs: $ cp -r _site/* ../docs And push your changes to your central GitHub-Repository. Publish Website Now publish your repository on GitHub Pages. Select your branch and as folder /docs and hit Save. Now you have to wait, this can take up to 10 minutes. On the top of the page a box will appear with the url of your website. Happy developing! Sources https://docs.github.com/en/pages/setting-up-a-github-pages-site-with-jekyll/creating-a-github-pages-site-with-jekyll https://docs.github.com/en/pages/quickstart https://docs.github.com/en/get-started/quickstart/set-up-git https://docs.github.com/en/pages/setting-up-a-github-pages-site-with-jekyll/testing-your-github-pages-site-locally-with-jekyll https://jekyllrb.com/docs/structure/ https://jekyllrb.com/docs/step-by-step/01-setup/ https://jekyllrb.com/docs/step-by-step/10-deployment/ \ No newline at end of file diff --git a/localdocs/_posts/2022-09-20-how-to-create-githubpage.html b/localdocs/_posts/2022-09-20-how-to-create-githubpage.html index fccb517..cc856dd 100644 --- a/localdocs/_posts/2022-09-20-how-to-create-githubpage.html +++ b/localdocs/_posts/2022-09-20-how-to-create-githubpage.html @@ -63,8 +63,9 @@ title: 2022 Week 38 How to create a static website with Jekyll and deploy it on gem "github-pages", "~> GITHUB-PAGES-VERSION", group: :jekyll_plugins
You can find the actual version of GitHub-pages here.
Now save and close the Gemfile.
-
- + +
+

Install bundle

Now still being at the localDev-directory, install the bundle:
$ bundle install
@@ -85,9 +86,13 @@ title: 2022 Week 38 How to create a static website with Jekyll and deploy it on $ JEKYLL_ENV=production bundle exec jekyll build
Your Jekyll-project was now build and stored at _site.
+ Clear your docs-directory: +
+ $ rm -r ../docs/* +
Now move the content of the localDev/_site to docs:
- $ cp -r _site/* ../docs
+ $ cp -r _site/* ../docs
And push your changes to your central GitHub-Repository.