Overview#

This short tutorial aims to simplify the process of reserve the syntax highlight property of any code blocks and paste them into other application such as Microsoft Word, Keynote, etc. conveniently with System Service routines and couple of clicks.

svn checkout https://github.com/tinng81/CopyHighlightService.git

in your Terminal app to directly download it.

Prerequisite#

1. Install Python-powered Syntax Highlighter Pygments via Terminal app

# Python 2.7
pip install pygments

# Python 3.x
pip3 install pygments

• pip/ pip3: Python Package Managers

2. (Optional) In case you don’t have Python installed yet. Download Python 3 Latest Release here ↗. Or follow the below script to install via command line.

# One-liner install homebrew using default Ruby shipped with your macOS Version
mkdir homebrew && curl -L https://github.com/Homebrew/brew/tarball/master | tar xz --strip 1 -C homebrew

# Then update the default PATH to use homebrew with your Shell
# Or other config file, E.g. '.bashrc'
test -f ~/.zshrc && echo "export PATH="/usr/local/bin:/usr/local/sbin:$PATH"" >> ~/.zshrc && source ~/.zshrc

# Verify successful installation
brew --version

# Install Python via Brew
brew install python

# Or specify a version
brew install python@2

# Lastly, install the Syntax Highlighter as in step 1
pip3 install pygments

About Pygments#

Python is an intepreted, high-level and without a doubt, the most common general-purpose programming language as of 2018.

Pygments is simply a syntax highlighter suitable for code hosting, forums, wikis or other applications that need to prettify source code.

From the Terminal, use command pygmentize to initiate and provide input flags to process your code block. If you have experience with Python, head to the next section on how to use Pygment in Python Environment.

touch test.py && echo 'print("Success") # Just a comment' > test.py

pygmentize -f html -O style=friendly,full=True -o result.html test.py 

open result.html

• touch: Create a file named test.py
• echo: Insert ‘{string}’ of text to designated file > {output}. This would also create file (if not exist) when invoked
• open: Open input file

Pygment flags explanation. Type pygmentize --help for a detailed manual.

1. -f: Format flag
2. -O: Option flags, comma separated values
3. -o: Output file (stdout)

Lastly, the test.py file was given as input (stdin) for the command.

The output result for Python using default Pygment style

Grab the example file array.py and try it yourself.

Automate with Services#

Now that you have an initial idea of how Pygments works, let’s try to automate copy code format with a couple of clicks.

Essentially, Services are pre-defined routines that aim to automate tasks using AppleScript. Open Automator app via Spotlight using ⌘-Space Bar keystroke.

Step 1 – Select Quick Action workflow

Simply put, the flow is to Copy the selected text (Step 1) $\rightarrow$ Prompt for highlighting language (Step 2) $\rightarrow$ Set variable value (Step 3) $\rightarrow$ Run command to

Step 2 – Select Input as Text. On the left panel, search & drag Copy to Clipboard action

Step 3 – Similarly, search & drag Set Value of Variable action, then select New Variable. This will serve as input for the final command

Ultimately, the whole workflow should look similar to this.

Step 4 – Finally, Add a Run Shell Script action, select your Shell and make sure it Pass input as arguments

• pbpaste & pbcopy: Command lines to provide text from Clipboard and add text to Clipboard. This setup serves our purpose of copy code blocks and later able to paste a highlighted version of it.

New Pygments flags are added as well as the full path in order to ensure all cases.

1. -g: Automatically detect Lexer from the content, i.e. the programming language.
2. -l: Manually input Lexer, i.e. the user-input in Step 3

export LC_CTYPE=UTF-8; 
pbpaste | /usr/local/bin/pygmentize -g -O style=colorful -f rtf -l  $1 | pbcopy

The command here has been revised and is a little bit different than the ‘raw’ one from previous section. Most importantly, the export command ensures that the copied text is in UTF-8 encode in order for this to work.

Command Line variant#

As a bonus, if you’re more comfortable working with CLI, there is a quick function for you. Usage is simply as passing any file into your CLI, for instance highlight array.py from the previous example.

echo -e 'function highlight() {/usr/local/bin/pygmentize -g -O style=colorful -f rtf $1 | pbcopy}' >> ~/.zshrc
source ~/.zshrc

Again replace the config file based on your Shell, the default is usually bashrc*

The result will be copy onto your Clipboard and is ready to paste in any other application that support RTF.

Explore highlight style#

To find more about available color scheme, simply type python3 to access Python Environment or use Python3 IDLE if you use a Graphical UI application and the following code

from pygments.styles import get_all_styles
styles = list(get_all_styles())
print(styles)

Troubleshooting (Extra)#

• Command not found with brew and/or python

Make sure that you have installed successfully, try source ~/.zshrc to refresh your Shell config file or simply open a new window.

• Command not found with Pygments

This is usually due to inproper installation of multiple Python version on your machine. Run

brew doctor && brew prune

to eliminate any empty keg and un-link unused dependencies.

Also, install Pygments with Python pip and NOT to be confuse with brew.