According to the Jekyll Documentation…
Jekyll is a simple, extendable, static site generator. You give it text written in your favorite markup language and it churns through layouts to create a static website. Throughout that process you can tweak how you want the site URLs to look, what data gets displayed in the layout, and more.
This sounds great! Can I create a Jekyll site on NorthStack? If so, how would I go about doing so?
For official instructions, see our documentation at the Jekyll/NorthStack Getting Started Guide
Yes, it is possible to create a Jekyll site on NorthStack by creating a static NorthStack application. You’ll then need to configure Jekyll’s…_config.ymlAnd set a destination parameter, and rebuild your application so that it deploys the static files into the proper NorthStack directory.Lets walk through this step by step..Step zero Some forethought…How you set up your application tree is up to you, but for this example our tree will look something like this….├── assets├── bin├── docker├── jekyllOnNorthstack <– our NorthStack application├── myJekyllSite <– or Jekyll application├── src├── tests└── vendorWhere Jekyll resides within our NorthStack client.Step three: Install NorthStackInstall NorthStack within the nsjekyllapp directoryStep two: Create a NorthStack applicationWithin your NorthStack directory create an Application on NorthStackStep three: Install JekyllLets install Jekyll within your NorthStack directory. The instructions can be pretty much be found here, but for MacOS users you may run into the following problem when running gem install jekyll bundler with the following error…gem install jekyll bundler ERROR: While executing gem ... (Gem::FilePermissionError) You don't have write permissions for the /Library/Ruby/Gems/#.#.# directory.There are a few options for fixing this issue, but for now we’ll cover the homebrew solution…brew install rubyAfter install your terminal will suggest you do the following…echo 'export PATH="/usr/local/opt/ruby/bin:$PATH"' >> ~/.bash_profileWhich will give access to the ruby library from your current directory.After this, you should be able to run the commands without issue…
_config.yml
gem install jekyll bundler ERROR: While executing gem ... (Gem::FilePermissionError) You don't have write permissions for the /Library/Ruby/Gems/#.#.# directory.
brew install ruby
echo 'export PATH="/usr/local/opt/ruby/bin:$PATH"' >> ~/.bash_profile
at this point, you’ve installed Jekyll! If you run…bundle exec jekyll serveYou should be able to view the site at You can run this if you’d like just to make sure Jekyll is working okay.Step four: Configure JekyllOnce you’re done checking things out stop the server (ctrl+c on MacOS) and look for your _config.yml./myJekyllSite├── 404.html├── Gemfile├── Gemfile.lock├── _config.yml├── _posts│ └── 2018-12-20-welcome-to-jekyll.markdown├── about.md└── index.mdwe want to add the following line to our _config.yml file..destination: ../jekyllOnNorthstack/app/publicabove the # Build Settings line. ../jekyllOnNorthstack/app/public is the relative location of our NorthStack application’s public directory. This is where your site files need to be when deploying to NorthStackOnce that’s saved we should check everything is okay! The Jekyll doctor command checks for major or potential issues for us.jekyll doctorFor this particular example, the issues shown seem okay. We can proceed to run Jekyll’s build command to deploy the necessary files to our NorthStack application…jekyll buildStep Five: Is everything there?Check your NorthStack application’s public directory, it should look something like this…../northstack/jekyllOnNorthstack/app/public/├── 404.html├── about│ └── index.html├── assets│ ├── main.css│ └── minima-social-icons.svg├── feed.xml├── index.html└── jekyll└── update└── 2018└── 12└── 20└── welcome-to-jekyll.htmlStep Six: Ready to deploy!If everything looks okay you can go ahead and deploy!northstack app:deploy "initial Jekyll release" jekyllOnNorthstack dev
bundle exec jekyll serve
destination: ../jekyllOnNorthstack/app/public
jekyll doctor
jekyll build
northstack app:deploy "initial Jekyll release" jekyllOnNorthstack dev
Like this content? Meet Pagely.
NorthStack Customers - Please login to access these features.Login
NorthStack® is a registered trademark and is made with love by the team at Pagely. Copyright 2021 Pagely, Inc. All Rights Reserved.