Prerequisites
Learn the basics of the JekyllEx app
Last updated
Was this helpful?
Learn the basics of the JekyllEx app
Last updated
Was this helpful?
Throughout these docs there may be some keywords used again and again. This reference should help you understand them better.
Home directory (HOME_DIR
): The folder that the app opens when the launched. This is the place that will contain the jekyll sites you choose to import.
The directory is an actual path in the device's internal storage: /data/data/xyz.jekyllex/files/usr/home
.
Clearing the app's storage from the device settings will wipe it and you will loose your work.
User directory (USR_DIR
): This resides just beside the home
dir, at usr
. It contains the symlinks to the executable software bundled in the Bootstrap.
Home page / : The page that usually launches when the app is first launched (after Bootstrap's Initial setup). You can explore folders and open files through this page.
/ Session logs: The bottom sheet accessible throughout the app, presenting the UI where you can run native commands and see their outputs live.
Session: The duration for which stays active. When it stops, the session ends.
The JekyllEx app bundles some required native software to run jekyll from within the app. This includes the whole ruby
ecosystem (cli tools like gems
, bundler
, etc.), along with git
and coreutils
.
The ruby
inside the app also includes and all of its dependencies as default gems so that the app's default behaviour works the same as it would on actual .
These software had to be patched and compiled from source to be compatible with the Android ecosystem, and on top of that replicate the environment to work with jekyll based sites flawlessly.
The bootstrap files are developed at the repository. The exact version of software embedded in a bootstrap can be checked from the corresponding .
When you open the app for the first time, it attempts to launch the bootstrap installer to install the bundled bootstrap files to their respective location from where the app can run them for you.
The installation process may take different amount of time depending on the processing power of your device.
A notification from the app titled "Process bridge" will be present whenever the service is active. It automatically updates its content to reflect any commands that are being executed.
The service binds with the app's UI so whenever you perform a UI based action like Previewing or using the Terminal, the command that gets executed is refelected by the service notification.
Whenever there is a command running, you can use the "Kill process" button in the notification to halt it right away. If the app is active, this action will be reflected in the terminal as well.
While the installation is in progress, you can push the app to background and come back to it later. But please avoid removing it from the recent apps or else the installation will abort halfway. You will have then have to launch the installer from settings manually (see ), in case things don't work right.
As soon as the app starts, it creates an responsible for executing native commands in the background.