Latex Colors Help
Name: | Latex Colors |
Version: | 0.6 |
Last update: | 2019-10-17 13:28:33 |
This package provides additional color support for TeX mode. You can turn
it on by selecting Alpha ↣ TeX Mode Setup ↣ Features and clicking on the
checkbox for LaTeX Colors.
Click here to display the TeX Mode Features Preferences
and activate this package.
Description
Once this package has been turned on, two new items can now be found in
the TeX Menu ↣ LaTeX Utilities submenu, named
- Color Window
- Remove Colors
which are described below. These items will add/remove colors and styles
to the {contents} of select commands.
Color Window
The first item (TeX Menu ↣ LaTeX Utilities ↣ Color Window) opens a
dialog in which you
can specify up to four different LaTeX items to which you would like
different colors to be added. All text in braces following the field name will then be colored, as in
\footnote{
This is text that would be colored
}
and
{\footnote This will also work}
The list of items available for colorizing can be found in the TeX mode
preference for Colorizable Items once this package has been turned on.
Items in this preference can be regular expressions if desired.
Click here to display the TeX Mode Preferences.
All settings are saved between editing sessions.
Pressing the TeX mode keyboard shortcut which has been defined for
Refresh LaTeX Colors as described below will first remove and then
add all of the colors and styles using the saved settings.
Remove Colors
The second item (TeX Menu ↣ LaTeX Utilities ↣ Remove Colors) will remove
all of the colors which have been added by the first item. They will be
re-applied the next time you use the keyboard shortcut for Refresh or
Center Refresh until you have either turned this package off or reset
all values in the Color Window dialog to their empty default values.
Keyboard Shortcuts
If you edit the text within the colored environments, you might find that
the text colors or styles are not consistently rendered. This package
defines two different configurable keyboard shortcuts to help clean up the
active window.
Refresh LaTeX Colors | ⌃⌥L |
Refresh LaTeX Colors Center | ⌃L |
The default values for these shortcuts are the same as Refresh and
Center Refresh that are used in all other Alpha windows. Pressing
Control-Option-L (⌃⌥L
) will update the
colors for you in the active window using the saved settings, while Control-L (⌃L
) will also center the window using
the cursor location. Click here to display the TeX Mode Preferences.
Testing
Want to test this package? Click here to open the LaTeX Example.tex
example window. This will temporarily activate this package for this
editing session, and offer the dialog for TeX Menu ↣ LaTeX Utilities ↣ Color Window. To turn this package on permanently,
you can adjust your TeX Mode Features Preferences .
Limitations
This feature is exploiting some of the window coloring options that are
made available by various Alpha core commands. In some cases we run into
some interference encountered with normal keyword colorizing
routines, as explained below.
If you want these colors to be automatically applied when you first open
a .tex window, you need to turn this package on globally.
Click here to display the Features Preferences dialog and activate
this package.
Technical note 1: Automatic colorizing with this package can
result in a considerable delay when .tex windows are first opened. Perhaps
we need a preference to decide if colors should be automatically applied.
Technical note 2: if the feature is only turned on for TeX
mode, the colors are only applied if the mode of the active window is TeX _before_ the new window is opened. The [openHook] procedure is
deregistered when switching out of TeX mode, and by the time it is
re-registered because TeX mode features are re-activated the window has
already been opened and the hook won't be called... We hope to address this
better in a future release, perhaps by always registering the [openHook]
and checking to see this package is still active, or making use of a
package's off script.
Known problems
Please report any problem or bug you encounter to
Alpha's Bug Tracker.
License and Disclaimer
Copyright (c) 2003-2019, Craig Barton Upright.
All rights reserved.
The latexColors package is free software and distributed under
the terms of the new BSD license:
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:
- Redistributions of source code must retain the above copyright notice,
this list of conditions and the following disclaimer.
- Redistributions in binary form must reproduce the above copyright notice,
this list of conditions and the following disclaimer in the documentation
and/or other materials provided with the distribution.
- Neither the name of Craig Barton Upright nor the names of its contributors
may be used to endorse or promote products derived from this software
without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL CRAIG BARTON UPRIGHT BE
LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
POSSIBILITY OF SUCH DAMAGE.