JekyllEx
v0.1.0
v0.1.0
  • Introduction
  • Getting started
    • Installation
    • Prerequisites
  • Usage
    • Projects
    • Explore
    • Manage
    • Previewing
    • Terminal
    • Settings
  • Other
    • Troubleshooting
    • Support
Powered by GitBook
On this page
  • Start the server
  • Preview
  • Stop the server

Was this helpful?

  1. Usage

Previewing

PreviousManageNextTerminal

Last updated 9 months ago

Was this helpful?

The core feature of the JekyllEx app is the ability to preview your jekyll site on device before pushing it to your version control / deployment platform.

JekyllEx features a feature rich previewer right besides the Editor.

Start the server

Unless the jekyll server is running, you can't preview your project. Jekyll can serve your site with a wide range of .

You need to for your project before continuing.

You can start the server both using the:

  • UI: The "▶" button on as well as "Start server" in the "⋮" dropdown menu.

  • Terminal: a valid jekyll command other than just jekyll serve.

JekyllEx reserves the jekyll serve command to build one that suits your needs. You can customize it under the in the settings.

For example,

  • Enabling will append bundle exec before jekyll serve.

  • Enabling will append the -l flag, etc.

  • Setting . All will be copied as they are.

You can view the full list of default customizations possible in the section on .

If you choose to use the terminal, these default configurations apply only when you use the jekyll serve command verbatim. Otherwise your command takes precedence.

Preview

Stop the server

The UI, terminal and the notification are all linked, so starting and stopping the server from one place or the other doesn't matter, it reflects everywhere.

For example, you can choose to start it from the UI and stop it from the notification.

Once the server runs, you can open any file and select the "Preview" tab. This will load the localhost server with the port 4000(customizable via ) that jekyll uses to serve your site by default.

If the is enabled, JekyllEx tries to determine the output url of a file. This is useful if you wish to directly preview a post / collection doc while editing it!

Since the serve command is run in the background by , you can choose to close the app and open localhost:4000 in your device's browser as well!

serve command options
install the dependencies
the process service
jekyll section
prefix bundler
live reload
custom flags
jekyll settings
settings
Guess destination setting