abjadcompile is an Atom package and Hydrogen plugin, created and maintained by the nCoda team, that enables Abjad to render .pdf files to an Atom text editor tab. In tandem with Hydrogen's line and block execution, abjadcompile enables you to iteratively compose and render scores in a newly flexible and integrated development environment.
pip install abjad to install Abjad into your Python environnment.
(2) Follow the Atom Flight Manual's instructions to download and install
abjadcompile from inside Atom (Atom>Preferences>Install>Search for
install). Atom should automatically install the package's Node and Atom package dependencies, with your permission.
(3) Make sure you can execute Python code via Hydrogen (
command+return). If you can't, Hydrogen should pop up a failure notifcation with instructions for installing a jupyter kernel, with a couple lines of clipboardable code to run in your Python environment.
(1) Start Hydrogen in a saved .py file.
(2) Invoke the
abjadcompile: attachMiddleware command – from [Atom's Command Palette](https://flight-manual.atom.io/getting-started/sections/atom-basics/, keyboard shortcut (
ctrl-alt-m), contextual (right-click) menu, or "Packages" menu – to insert the Abjad middleware into Hydrogen's kernel communication loop.
(3) Use Hydrogen's execution commands to run any code containing
component is an illustratable Abjad component, and the object will open as a .pdf in a new Atom tab.
N.B. - All .pdf files render to a temporary directory but can be saved to disk by clicking the pdf file's path in the lower-left-hand corner of Atom when the pdf's tab is selected.
# must be saved as something.py import abjad note = abjad.Note() abjad.show(note)
Kernel shutdown/restart currently requires window reload, as the abjadcompile plugin thinks middleware is already attached.
Good catch. Let us know what about this package looks wrong to you, and we'll investigate right away.