# QuickText

QuickText - Quick editing tags for Notepad++
Copyright (C) 2006  João Moreno (alph.pt@gmail.com)

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License along
with this program; if not, write to the Free Software Foundation, Inc.,
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.

Original Link:    http://sourceforge.net/projects/quicktext/
Original Author:  Joao Moreno <alph.pt@gmail.com>, Jing Teng <jingbeta@gmail.com>
Original Version: 0.0.2.1

Based on Version: 0.0.2.2

Link:         https://sourceforge.net/p/quicktext/patches/4/
Author:       TonyM

Description

QuickText is a Notepad++ plugin for quick text substitution, including multi field inputs. It's similar to Tab Triggers in TextMate.

Build

I compiled with MS Visual Studio Community 2017 and this seems to work OK.

For 32-bit:

[x86 Native Tools Command Prompt for VS 2017]

    C:\> set Configuration=Release
    C:\> set Platform=x86
    C:\> msbuild

For 64-bit:

[x64 Native Tools Command Prompt for VS 2017]

    C:\> set Configuration=Release
    C:\> set Platform=x64
    C:\> msbuild

Installation

Copy the:

• 32-bit: ./bin/QuickText.dll
• 64-bit: ./bin64/QuickText.dll

to the Notepad++ plugins folder:

• In N++ <7.6, directly in the plugins/ folder
• In N++ >=7.6, in a directory called QuickText in the plugins/ folder (plugins/QuickText/)

NOTE: The original version put config files in weird places and with no updates since the Notepad++ 7.6 new plugins architecture, it's gotten worse. This version corrects this. You'll need to put the following files (or your existing versions) in their respective directory locations:

Config/QuickText.conf.default.ini = NPP_INSTALL_DIR/plugins/Config/QuickText.conf.ini
Config/QuickText.default.ini      = NPP_INSTALL_DIR/plugins/Config/QuickText.ini

Usage

Assign a shortcut key to the Plugins => QuickText => Replace Snip menu to use QuickText snips from within the current Notepad++ document.

If the "Replace Snip" hotkey is used and there is no text before it or no valid expansion for the text before it, the "Replace Snip" hotkey character is inserted. For example, using Tab as the key with no valid expansion just inserts a tab (as if Tab key press).

Once a snip is inserted, you can use the "Replace Snip" hotkey again and again to navigate through the hotspots in the inserted snippet.

NOTE: Tab can now be used again as the "Replace Snip" hotkey. There is no default.

Customization

Settings:

Use to configure Snips for languages.

• Use Scintilla Autocomplete: uses Scintilla autocomplete while typing to suggest snips for the current language. Without this enabled, you need to trigger the "Replace Snip" hotkey to get the autocomplete list or just type a snip from memory.
• Auto Insert Autocomplete: when a snip is completed from a Scintilla autocompletion, expand the snip. Without this enabled, you need to trigger the "Replace Snip" hotkey again to expand the snip.
• Convert Tabs (N++ setting): convert any Tab characters in the "Substitution Text" to spaces based on Notepad++ settings for the current language. If Notepad++ does not replace tabs for the current language, this setting respects that. If Notepad++ does replace tabs with a given number of spaces, that number of spaces is used in the replacement.
• Use Fixed Font: use a fixed-width font (Courier New) in the "Substitution Text" text box.
• Use N++ Colors: use Notepad++ background and "Default Style" text colors in the "Snips" and "Substitution Text" list and edit boxes.
• Confirm before close: use message box prompts to confirm actions before closing the Settings dialog with the "OK" and "Cancel" buttons if potential changes.

To make you're own snips:

• Snips file (QuickText.ini) MUST use "Windows (CR LF)" line endings.
• First make sure the snip's Language Section already exists. This is done by creating a new section with the code corresponding to the Language. See LANGUAGE CODES.
• Then, for the key of the snip, use only lower/upper case and numbers.
• Special chars:
  • $ hotspots
  • \$ for literal '$'
  • \n for line break
  • \\n for literal '\n'

When using the Settings "Substitution Text" GUI:

• Ctrl+Tab for literal tab
• $ hotspots
• \$ for literal '$'
• Enter for line break
• \n for literal '\n'

Example

8 is the Language Code for HTML

[8]
link=<a href="https://github.com/vinsworldcom/nppQuickText/blob/main/$">$</a>

LANGUAGE CODES

0   TEXT
1   PHP
2   C
3   CPP
4   CS
5   OBJC
6   JAVA
7   RC
8   HTML
9   XML
10  MAKEFILE
11  PASCAL
12  BATCH
13  INI
14  ASCII
15  USER
16  ASP
17  SQL
18  VB
19  JS    # Do not use for JavaScript, use 58 instead
20  CSS
21  PERL
22  PYTHON
23  LUA
24  TEX
25  FORTRAN
26  BASH
27  FLASH
28  NSIS
29  TCL
30  LISP
31  SCHEME
32  ASM
33  DIFF
34  PROPS
35  PS
36  RUBY
37  SMALLTALK
38  VHDL
39  KIX
40  AU3
41  CAML
42  ADA
43  VERILOG
44  MATLAB
45  HASKELL
46  INNO
47  SEARCHRESULT
48  CMAKE
49  YAML
50  COBOL
51  GUI4CLI
52  D
53  POWERSHELL
54  R
55  JSP
56  COFFEESCRIPT
57  JSON
58  JAVASCRIPT
59  FORTRAN_77
60  BAANC
61  SREC
62  IHEX
63  TEHEX
64  SWIFT
65  ASN1
66  AVS
67  BLITZBASIC
68  PUREBASIC
69  FREEBASIC
70  CSOUND
71  ERLANG
72  ESCRIPT
73  FORTH
74  LATEX
75  MMIXAL
76  NIM
77  NNCRONTAB
78  OSCRIPT
79  REBOL
80  REGISTRY
81  RUST
82  SPICE
83  TXT2TAGS
84  VISUALPROLOG
85  TYPESCRIPT
86  EXTERNAL

255 GLOBAL