ExplorerUser Guide
Overview
Explorer
is a file explorer application based on the Reflux framework. More than an application, Explorer also provides reusable Views and Editors. Explorer may also be enhanced through the use of Plugins.
Features:
- System file explorer
- Fantom documentation viewer
- A better web browser / html viewer
- Fandoc file viewer
- Resource Tree
- Text editor (borrowed from fluxText)
- Syntax highlighting (uses syntax)
Small things that make me use it:
- Quick view / edit toggling with F12
- Easily show / hide hidden files
- Text editor word wrapping (configurable)
- Address bar accepts pod names, e.g.
afIoc
Quick Start
Simply start Explorer from the command line:
C:\> fan afExplorer [afIoc] Adding module definition for afReflux::RefluxModule [afIoc] Adding module definition for afExplorer::ExplorerModule ___ __ _____ _ / _ | / /_____ _____ / ___/__ ___/ /_________ __ __ / _ | / // / -_|/ _ /===/ __// _ \/ _/ __/ _ / __|/ // / /_/ |_|/_//_/\__|/_//_/ /_/ \_,_/__/\__/____/_/ \_, / Explorer v0.0.4 /___/ IoC Registry built in 216ms and started up in 10ms
Explorer may optionally be started with a list of URIs to be opened up in tabs:
C:\> fan afExplorer C:\Temp C:\> fan afExplorer http://www.fantomfactory.org/ C:\> fan afExplorer afIoc::Registry
Usage
Following Reflux browser behaviour, entering valid URIs in the address bar will bring up an associated View for that resource.
If there are multiple Views available for the resource, a drop down will appear in the address bar allowing you to toggle between them:
You may also specify the view by adding a query parameter to the URI:
file:/C:/Projects/Explorer/pod.fdoc?view=afExplorer::TextEditor
You may also specify a URI to be opened in a new tab, regardless of if the view is configured for re-use or not:
file:/C:/Projects/Explorer/pod.fdoc?newTab=true
File Explorer
Explorer may be used to explore your file system using the file:
scheme. URIs should be absolute and the path should begin with a /
.
file:/C:/Projects/Explorer/
You may also enter an OS specific path:
C:\Projects\Explorer
Files may be opened up in a:
- Text Editor
- HTML Viewer
- Fandoc Viewer
- Image Viewer
Web Browser
Explorer may also be used as a (basic) web browser by entering a http:
scheme:
Fandoc Viewer
Explorer can view all the Fantom documentation held in the current Fantom installation. This includes all the API docs for all the installed pods. It uses a fandoc:
scheme with the following format:
fandoc:/<pod>/<type>/<slot> fandoc:/afReflux/View/onLoad
The address bar also accepts simple fandoc notation (case insensitive):
afReflux afReflux::View
Press F1
at anytime to being up the Fandoc index.
Plugins
Exoplorer may be customised though Plugins.
A plugin is any Fantom pod that defines an index property of afExplorer.module
, the value of which should be the qualified type name an IoC AppModule
.
index = [ "afExplorer.module" : "myExplorerPlugin::PluginModule" ]
On startup, Explorer scans the current Fantom installation for these pods and automatically adds them to its IoC module list. These plugin modules may then configure anything a reflux application can.