From 4e2422d29f6368c08e1bc08dbd31692d996c75c9 Mon Sep 17 00:00:00 2001 From: "dziltener@lyrion.ch" Date: Tue, 1 Aug 2017 16:43:10 +0000 Subject: [PATCH] Manual draft. --- doc/janix-texinfo.css | 936 ++++++++++++++++++++++++++++++++++++++++++ manual.texi | 176 ++++++++ 2 files changed, 1112 insertions(+) create mode 100644 doc/janix-texinfo.css create mode 100644 manual.texi diff --git a/doc/janix-texinfo.css b/doc/janix-texinfo.css new file mode 100644 index 0000000..06342da --- /dev/null +++ b/doc/janix-texinfo.css @@ -0,0 +1,936 @@ + + + + + + + + + + + + + + + + + + + + + + + + Janixman/janix-texinfo.css: A CSS stylesheet for Texinfo HTML output produced by texi2any 5.0 (or higher) + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Skip to content + + + + + + + + + + + + + + +
+ +
+
+ + +
+
+
+ +
+
+ + + +
    + +
  • +
    + +
    + + + + Watch + + + + +
    + +
    +
    +
    +
    • + +
  • + +
    + +
    + + +
    +
    + + +
    + +
    • + +
  • + + + Fork + + + + + +
    • +
+ +

+ + /janix-texinfo.css + + + + + +

+ +
+
+ + + +
+
+ +
+
+ + +
+ + A CSS stylesheet for Texinfo HTML output produced by texi2any 5.0 (or higher) + + +
+ + +
+
+
+ + +
+
    +
  1. + + + CSS + 100.0% + +
    2. +
+
+
+
+
+ +
+ CSS +
+ + + +
+
+
+ +
+ +
+ + + + Find file + +
+
+ +
+
+ + +
+
+
+ +
+ +
+ +
+ +
+ +
+ +
+
+
+ +
+
+ + +
+ + Download ZIP + +
+
+
+ + +
+ + + +
+ + + + New pull request + + +
+ +
+
+ + + + + + +
+ + Latest commit + + 39b01c5 + + + + + + + @Janixman + + + + Updated README to remove texinfo, bison, and emacs samples. + + +
+ + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Failed to load latest commit information.
+ + + + FIXME + + + Added FIXME to the repository. + + + +
+ + + + LICENSE + + + v1.0 release version of janix-texinfo.css + + + +
+ + + + README + + + Updated README to remove texinfo, bison, and emacs samples. + + + +
+ + + + janix-texinfo.css + + + Fixed the margins for UL elements + + + +
+ +
+ + + +
+

+ + README +

+ + 
------------------------------------
+README for janix-texinfo.css
+------------------------------------
+
+The purpose of this cascading style sheet (CSS) is to decorate the
+Texinfo HTML output produced by texi2any v5.0 (or greater).
+
+***
+
+Use the following syntax to build HTML with this stylesheet:
+
+    texi2any --split=node --html --css-ref=janix-texinfo.css --set-customization-variable WORDS_IN_PAGE=0 my-info-file.txi
+
+------------------------------------
+END OF README
+------------------------------------
+
+
+ + +
+
+
+ +
+
+ +
+ +
+ +
+ + + + + + + +
+ + + Something went wrong with that request. Please try again. +
+ + + + + + + + + + + + + + diff --git a/manual.texi b/manual.texi new file mode 100644 index 0000000..d553c95 --- /dev/null +++ b/manual.texi @@ -0,0 +1,176 @@ +\input texinfo +@setfilename clojurefx +@settitle ClojureFX Manual + +@copying +This manual is for ClojureFX, version 0.3.0. + +Copyright @copyright{} 2017 Daniel Ziltener. +@end copying + +@titlepage +@title ClojureFX Manual +@author Daniel Ziltener + +@page +@vskip 0pt plus 1filll +@insertcopying + +@end titlepage + +@contents + +@ifnottex +@node Top +@top ClojureFX + +This is the documentation to ClojureFX, version 0.3.0. +@end ifnottex + +@menu +* Installation and deployment:: adding ClojureFX and probably tools.jar to your build tool. +* Getting started:: the little ceremony necessary to get a window ``up and running''. +* Coding a scenegraph:: for everyone who wants to write an UI the old-school way. +* FXML and controllers:: loading FXML files and generating a controller. +* Event handling:: a short chapter about handling events. +* Index::. +@end menu + +@node Installation and deployment +@chapter Installation and deployment + +The first, straightforward part of this is to add the dependency to your @file{project.clj} or @file{build.boot}, which consists simply of adding @code{[clojurefx "0.3.0"]}. + +In case you are planning to use the FXML controller generator (and in my opinion, you really should!), you have to add @file{tools.jar} to your classpath. For Leiningen, there is a @uref{https://github.com/pallet/lein-jdk-tools, plugin}. The gist of it is to add @file{$JAVA_HOME/../lib/tools.jar} to your @code{:resource-paths} and if possible put it into an exclusions list for the main jar; that way it will still be packed into the uberjar. + +For the users of @emph{OpenJDK} 7 and 8, @emph{OpenJFX}, the opensource implementation of JavaFX, is not included yet (it will be starting with OpenJDK 9). Luckily, many Linux distributions ship a separate OpenJFX package by now, but for those that don't, the OpenJDK wiki has an article @uref{https://wiki.openjdk.java.net/display/OpenJFX/Building+OpenJFX, ``Building OpenJFX''}. + +@node Getting started +@chapter Getting started + +@code{(require '[clojurefx.clojurefx :as fx])} + +To get the JavaFX environment up and running, you can't just initialize some classes and fire up a window, as is the case with Swing; you first have to initialise the environment. For this, you have two choices: either use a ``nasty hack'' Oracle themselves show, or go down the Java road and subclass @indicateurl{javafx.application.Application}. + +For the ``nasty hack'', you have to add a @code{defonce} @emph{before} you import JavaFX classes (so, best suited for a @file{core.clj} ns). You can then manually create a @code{Stage} and add a @code{Scene} to it. + +@code{(defonce force-toolkit-init (javafx.embed.swing.JFXPanel.))} + +Subclassing @indicateurl{javafx.application.Application} is a tad more work and requires you to aot-compile the namespace: + +@lisp +(ns example.core + (:require [clojurefx.clojurefx :as fx]) + (:gen-class :main true + :extends javafx.application.Application)) + +(defn -init [this] + nil) + +(defn -start [this ^javafx.stage.Stage stage] + (.show stage)) + +(defn -stop [this] + nil) + +(defn -main [& args] + (javafx.application.Application/launch example.core args)) +@end lisp + +@node Core API +@section Core API + +@deffn clojurefx.clojurefx run-now code +This macro runs the code given on the JavaFX thread and blocks the current thread until the execution has finished. +@end deffn + +@deffn clojurefx.clojurefx run-later code +This macro runs the code given on the JavaFX thread and immediately returns. Prefixing the s-exp with an @@ has the same effect as using @code{run-now}. +@end deffn + +@node Coding a scenegraph +@chapter Coding a scenegraph + +@strong{This part of the library has not been tested for a long time; I will get to it eventually, but expect things to be somewhat broken.} + +@lisp +(require '[clojurefx.clojure :refer [compile]]) +(compile [VBox @{:id "TopLevelVBox" + :children [Label @{:text "Hi!"@} + Label @{:text "I'm ClojureFX!"@} + HBox @{:id "HorizontalBox" + :children [Button @{:text "Alright."@}]@}]@}]) +@end lisp + +@node Scenegraph API +@section API + +@deffn clojurefx.clojurefx compile code +Turns the Hiccup-like tree into a JavaFX-Node. +@end deffn + +@node FXML and controllers +@chapter FXML and controllers + +@code{(require '[clojurefx.fxml :as fxml])} + +@acronym{FXML} is an @acronym{XML} format describing a JavaFX user interface. It also allows defining action handlers and, similar to HTML, inline scripting via script tags. You can find an introduction @uref{https://docs.oracle.com/javase/8/javafx/api/javafx/fxml/doc-files/introduction_to_fxml.html, on this site}. + +ClojureFX provides an idiomatic interface to load FXML files, and in this new version can even generate a controller class for you at runtime. For the latter, the user has to have @file{tools.jar} on his classpath (@pxref{Installation and deployment}). + +@node Loading FXML files +@section Loading FXML files + +So you created an @acronym{FXML} file, probably with the SceneBuilder, and obviously now want to use it in your application. Doing so looks tedious in the JavaFX docs, but it is actually straightforward. All you need is some place to add the loaded Node - this could be the Scene object, or simply any JavaFX Parent element. The loader function returns a pure javafx.scene.Node-based object. + +@lisp +(require '[clojurefx.fxml :as fxml]) +(def mainwindow (fxml/load-fxml "resources/fxml/mainwindow.fxml")) ;; => javafx.scene.Node +(.setContent my-scroll-pane mainwindow) +@end lisp + +You're already good to go! + +@node Generating controller classes +@section Generating controller classes + +When creating an @acronym{FXML} file, you have built-in features to bind properties and call functions in an associated controller class. Before actually writing any Clojure, let's see how you can prepare your @acronym{FXML} file to get the most out of it. + +First, at your outermost element in the file, you have to tell it the class name of its @acronym{JVM} sibling it is going to call. For that, open it, and add the @option{fx:controller} attribute: @code{fx:controller="ch.lyrion.MyController"}. It is not very important how you name the class, as long as it has a package and doesn't exist anywhere else. + +To bind any element to your new controller (in the form of a @code{Property}), you need the @option{fx:id} attribute. Let's try it with that label: @code{