Constructing Crosswords: Approach
Constructing Crosswords: Approach
Focus | Grid Size & Format | Constructors? |
Rules, Conventions | Apps, Dictionaries, Tools | References
Focus
- My introductory CROSSWORDS and YOU course focused on solving crosswords,
via lecture and group practice; it also highlighted history, showed where to find puzzles,
and briefly & broadly covered authoring (constructing). - This course focuses on constructing crosswords
-- appreciating nuances of themes, grids, fill and clues may help you become a better solver.
Wanting to construct your own puzzles is not a pre-requisite. - What other differences in coverage or approach?
Grid Size & Format
- There many possible word puzzle sizes, layouts, languages:
CROSSWORDS and YOU: Terminology & Types. - The focus in this course: American, themed daily crosswords, e.g., NYT Mon-Thu.
- American newspaper-style, fully-crossed*, symmetric grids [on right]:
e.g., New York Times (NYT) Los Angeles Times (LAT),
Universal (Mail Tribune), Wall Street Journal (WSJ), etc.
-- not vocabulary-style, free-form, criss-cross word puzzles [top right],
or British-style cryptics [below right];
*aka 'fully-checked': each answer square has both an Across and Down clue, i.e., no 1-letter words (usually) - themed: e.g., NYT:Mon-Thu, Sun
-- not NYT:Fri-Sat (themeless; hardest! What Makes a Good Themeless Puzzle?) - 15 x 15 size: e.g., NYT:Mon-Sat -- not NYT:mini 5 x 5 [on right] or NYT:Sun 21 x 21
-
Note: NYT Sun 21 x 21 ranks in difficulty like ~Wed/Thu NYT
-- though solving takes longer (~2x more squares: 441 vs. 225);
constructing larger grids is more challenging: more theme entries, even higher quality fill & clues, etc. - "A 78-word 15x15 typically has an average word length of ~4.8-5.0 letters?
A 72-word 15x15 themeless is probably around 5.5-5.6 letters
and a 140-word 21x21 themed is often like 5.3" ~Evan Birnholz on Crosscord(Discord)
Who Can Be A Constructor?
- In the past, typically old white guys. ;-)
- Now (increasingly), anyone with great ideas, new perspective -- and the right skills/tools.
- Will Shortz: "In the 90s, my sense is that the average age of constructors
[who submitted puzzles] was in the early 50s. Now it’s in the mid-30s." - What's come of this trend is a positive feedback loop of young constructors
attracting young solvers who in turn become young constructors. - The catalysts for this are many: the ease of access to puzzles online;
- software that makes puzzle construction more fun and less daunting;
- an increase in social networking and collaboration among both setters
and solvers (as on XWordInfo.com and Cruciverb.com); - Deb Amlen’s Wordplay column, whose goal is to "help those intimidated
by the NYT crossword get over their fear of the puzzle." - even the rise of diverse, indie crossword communities all over the country
focused on those historically underrepresented in puzzledom
-- the LGBTQ+ community, female constructors, and people of color. - source: Smithsonian: How Crosswords Came of Age in the 2010s
- "Of the 28 puzzles I’ve had published in The New York Times, 21 of them have been collaborations.
I've shared a Times byline with 15 different constructors. While I do enjoy working on puzzles on my own,
there's something special about the collaborative process. It makes the puzzle more memorable,
and it inspires me to put out my best work. While I might end up setting aside a puzzle
I’m working on alone, a collaborator keeps me motivated to take a puzzle across the finish line.
Each person I’ve worked with has taught me something new, whether they are more or less experienced than I am.
In my first collaboration with Matthew, which was published in the Crosswords Club, Matthew showed me how to make a
shared Google spreadsheet for writing clues in a more collaborative way. I’ve used this format for every puzzle since!
Collaborators have made me question the vocabulary I use in a grid, or what is considered too 'crosswordy.'
They've made me more comfortable with ripping up an entire grid and writing multiple clues to choose from
for a single entry. Two heads are better than one when it comes to coming up with funny theme entries.
If you're interested in crossword construction, I’d highly recommend teaming up with someone
more experienced than yourself; you will definitely learn something — and they probably will, too."
~Christina Iverson, Easy Mode newsletter, 4/26/2024
Rules / Conventions
- When creating free-form or crossword puzzles for yourself or friends,
you can choose any words, grid size, layout, clues, etc. - The focus in this course: follow the 'rules' that solvers & publishers expect, e.g., symmetry, word choice, ...:
- Publisher Specs/Submission Guidelines: NYT, LAT, Univ., WSJ, etc.
- Cruciverb.com: basic rules
- NYT: How to Make a Crossword Puzzle: The Series: Parts 1-5
- Wikipedia: NYT: Style and conventions
- XWordInfo.com
- Margaret Farrar: Contributions and Accomplishments
- "Learn the rules...
- Rules can sometimes be broken -- there's more latitude with an exceptional puzzle and a great justification.
- Following the rules doesn't guarantee a good crossword, e.g., The World's Worst Crossword
- We'll cover many of these conventions in upcoming sections: Themes; Grid; Fill; Clues; Publish
Apps / Dictionaries / Tools
- CROSSWORDS and YOU: Authoring surveyed methods used by constructors:
- paper: e.g., WordPlay documentary
- web sites/apps: e.g., Armored Penguin (free-form only); Crosserville, Crosshare, PuzzleMe
- applications: e.g., CrossFire, Crossword Compiler
- The focus in this course: CrossFire application, with add-on dictionaries
to construct 15 x 15 themed crosswords, with in-depth examples. - next sections: Overview of Process; Tools; Formats
References
- How a Crossword Puzzle Gets Made video: 3:32; Mike Vuolo; Slate; 11/12/2014
- NYT: How to Make a Crossword Puzzle: The Series
Part 1: Theme; 2: Grid; 3: Fill; 4: Clues; 5: Publish; Resources - Crossword Constructor's Handbook by Patrick Berry; $10; e-book (.pdf) 89 pp.,
plus 70 sample puzzles; originally published as Crossword Puzzle Challenges for Dummies, 2004 - The Art of Crossword Construction William Johnston; .pdf; 7pp.; free; 1/26/2010
- How Crossword Puzzles Are Really Made Matt Gaffney; MF; 9/10/2014
- Themed Puzzle Construction Christoper Adams; .pdf, 8 pp., free; puzzle, 2/2018
- Walkthrough: Making a Puzzle with CrossFire theme, grid, fill, clues, publish
- How-to videos (YouTube, Twitch): Erik Agard; Alex Boisvert (Crossword Nexus);
Will Eisenberg; Sid Sivakumar; Ross Trudeau and Amanda Rafkin; Brian Thomas;
Six-part video series from The New Yorker; Crossword Jargon Glossary - cruciverb: Crossword Constructors Community Center
- XWord Info: New York Times Crossword Answers and Insights
- Atlas Obscura: Creating Crossword Puzzles course; Brooke Husic & Natan Last; $70
- CROSSWORDS and YOU (course); Authoring: Introduction, References
Constructing Crosswords: Free-Form
Constructing Crosswords: Free-Form
A Digression | Tools | Example
A Digression
- Free-form --aka vocabulary or criss-cross -- word puzzles are an easy way to get started.
- Compared to creating a symmetric, newspaper-style crossword, the free-form process is much simpler:
- Theme: just a list of words; no need for consistency, cleverness or matching lengths
- Grid: words laid out automatically; symmetry, size and unchecked squares are not an issue.
- Fill: no extraneous words needed -- only your list is included.
- Clues: the same process, but you can make clues personalized.
- Publish: usually for self, family or friends rather than formal publication.
Tools
- Some apps can create free-form puzzles -- see Authoring: Applications
- e.g., Crossword Compiler app example [image: right]
- You can disable 'normal' rules in some apps, e.g.,
Crossfire: Grid > Preserve symmetry, Grid > Report Unchecked Squares
- Many browser-based sites, often education-oriented, are free or low cost.
- General process/features:
- Adjust options for size, background; add a title and author.
- Enter a list of words and clues into a form or import a text file -- answer|clue delimiter may vary
- Automatically generate a skeleton-like arrangement of your words.
- Review, revise word list and/or settings
- Export resulting free-form puzzle and solution as .pdf, .jpg, .png.
- Optional: copy/rearrange/reformat grid, clues and/or solution in a document editor; add pictures.
- Print / publish!
- 3 free sites:
- 1. simplest: Discovery Education: PuzzleMaker paste from edited demo.txt
- 2. format options: Crossword Publisher [image: right]; no import
- 3. more options: Armored Penguin [image ('Crosspassword'): top right; example below]
- For other free-form puzzle sites to explore: Authoring: Web
Example: Armored Penguin
- Add a Title, Author; many options: square size; bkgd: gray; min groups: 1; etc.
- Enter answers and clues manually --
- Or, edit/save a local text file; each line contains answer:clue
Text file name: Choose File
(download demo file);Load Puzzle
Make Puzzle
- Revise words, clues, appearance, etc.?
- Printable PDF (example .pdf; image: right), Answer Key, Online, etc.
Constructing Crosswords: Process
Constructing Crosswords: Process
Overview | 0. Prepare | 1. Theme |
2. Grid | 3. Fill | 4. Clues | 5. Publish
Overview of Process
- "A crossword puzzle is a battle between the...
- "When I tell people at parties that I write crossword puzzles for a living
the first question they ask is 'Which do you write first, the clues or the grid?'... - "I'm often asked: 'Which comes first, the words or the clues?'...
- Videos: How a Crossword Puzzle Gets Made 3:32; Mike Vuolo; Slate; 11/12/2014
- "I would like to construct my own puzzles but don’t quite know where to begin or proceed.
The crossword constructing community is one of the most welcoming communities I’ve ever
encountered. It seems as if there’s nothing an experienced constructor loves more than
to help out people who are interested in making their own puzzles; most of the grid makers
I know started out with help from an experienced mentor. I highly recommend connecting
with other constructors online or in person. Facebook and Discord both have active
communities of constructors.
And consider attending a crossword puzzle tournament. The American Crossword Puzzle
Tournament in Stamford, Conn., is the biggest, but you can find ones in New York City,
Boston, the Midwest and the Bay Area. Many of these tournaments have online components,
allowing you to connect with other puzzle people from the comfort of your home.
If you want to get started on your own, just about any experienced constructor will tell you to
read Patrick Berry’s Crossword Constructor’s Handbook, which you can download for $10 online.
The manual carefully lays out the steps of constructing a crossword: developing a theme,
making the grid skeleton, filling the grid and writing clues. It's the most in-depth resource
you will find. I highly recommend the NYT series on constructing, with suggestions of software,
word lists and other tools for constructing." ~Christina Iverson; NYT Easy Mode newsletter; 2/2/2024
0. Prepare
- Choose: audience? puzzle type? grid size? difficulty?
- Gather apps, tools, dictionaries, understand general rules
- Review Crossword Publication Specs comprehensive table from Matthew Stock
e.g., NYT; LAT, Universal, WSJ, et al.; - Cruciverb: specs, comparison (older)
- Choose a target publication -- or follow common guidelines, and decide later.
-
Some publishers may request an initial theme proposal rather than a complete crossword,
-- and reply with their (dis)interest more quickly before you expend construction effort. - New publishers may seek crosswords, sometimes announced on Cruciverb.com, e.g.,
"This announcement is to help Matthew Dube at Merriam-Webster. He wrote me that M-W and Britannica are
planning a new six-day-a-week online crossword series, consisting of five 15x15 dailies and one 21x21 Sunday.
They're looking for two or three regular contributors.
The focus of the puzzle will be interesting English vocabulary. And since the puzzle will have an international audience,
it shouldn't have a lot of names -- especially ones that aren't internationally known.
The pay, I'm told, will be modest, but in keeping with a number of other markets. If you're potentially interested
in an ongoing gig like this, please send your name and list of credits, along with any comments, to Matt..."
~Will Shortz; 12/4/2020; [on constructor email list: cruciverb-l@mail.cruciverb.com] - Allow enough time, e.g.,
- "How long a puzzle takes to create depends on a lot of things —...
- Matt Gaffney describes a complete themed puzzle constructed in less than 6 hours! 9/10/2014
- The Super Mega (50 x 50) puzzle, the largest one Jeff Chen has constructed, was weeks of effort.
'It nearly killed me,' he said, laughing
Meet Jeff Chen, the Seattle man who’s published more than 125 crosswords in The New York Times; ST; 1/6/2022 - So, How Long Does It Take to Make a Crossword Puzzle Anyway? DB; 2/22/2021
- "Generating the theme is always the hardest part of this job...
- "How long does it take to build one crossword puzzle?
The short answer is, it really depends on the puzzle and the constructor.
The first step of constructing a themed puzzle is to come up with the theme
and a workable theme set, which is a set of longer entries that all have
something in common. For many constructors, this is what takes the longest.
While a theme can fall together quickly, I’ve spent weeks and sometimes over
a year trying to come up with the perfect theme set. I often start thinking
about a puzzle because of a single pun, and then I search for similar examples.
Because theme entries in crossword puzzles must be symmetrical in the grid,
constructors can't just think of a few theme entries and call it a day.
We have to create partner entries of matching lengths -- and then make sure
those entries have letters that fit in a 15x15 grid (or 21x21 for a Sunday puzzle).
After the theme set, it’s on to the grid. While modern crossword software
can generate a filled grid in seconds, it takes time to create a one that
feels human. Many constructors enjoy tinkering with the words and trying
to craft the best possible 'fill,; otherwise known as the words or phrases
that fill a crossword. Some people spend weeks playing with a grid,
while others spend just a few hours. The same is true with writing clues;
one constructor might power through every clue in one sitting, while another
might spend weeks writing one clue at a time, when inspiration strikes.
The whole process might take eight hours or eight years; we recently accepted
a puzzle from someone who said he has been revising it since 2015!"
~Christina Iverson, Easy Mode newsletter; 12/29/2023 - How to Make a Crossword Puzzle, Part 5: The Crossword Editors's Job; Resources:
word lists, software, online resources; NYT; 8/17/2018 - Crossword Constructor Resource Guide
Construction Software; Online Dictionaries;
Word Lists; Places to Meet Other Constructors;
Publications With Open Submission Guidelines;
Other Useful Tools and Websites; Crossword Blogs and Columns;
Inspiration; Puzzle Tournaments; NYT; 11/8/2021 - Crossword Constructor's Handbook (Berry) Chapter 6: Odds and Ends: Useful Resources
- The Art of Crossword Construction (Johnston): Resources for Making Puzzles
- Amuse Labs: Resources
- Constructing Crosswords: Tools
1. Theme
- Brainstorm possible interesting, "lively" theme entries
(word or phrase answers); list desired words for themeless/free-form - Match paired-length theme entries
- Draft theme clues to ensure consistency.
- NYT: How to Make a Crossword Puzzle, Part 1: Developing the Theme;
How do puzzle makers get started? two NYT constructors,
Ben Tausig and Finn Vigeland, demystify the process of developing a theme set; 4/11/2018 - Crossword Constructor's Handbook (Berry)
Chapter 1: Developing a Theme for Your Puzzle - The Art of Crossword Construction (Johnston): Themes in Crosswords
- How Crossword Puzzles Are Really Made Matt Gaffney; MF; 9/10/2014
- Constructing Crosswords: Themes
2. Grid
- Enter long theme entries
- Add blocks (black squares) to create easier to fill areas, while maintaining grid symmetry/connectivity
- For free-form, use site/app to generate grid from word list
- NYT: How to Make a Crossword Puzzle, Part 2: Designing the Grid; Building the framework for a puzzle
puzzle makers David Steinberg and Natan Last design a crossword grid around our theme set; 5/11/2018 - Crossword Constructor's Handbook (Berry) Chapter 2: Designing the Grid
- The Art of Crossword Construction (Johnston): Grid Pattern Conventions: Grid features
- Constructing Crosswords: Grid
3. Fill
- Fill-in other entries; avoid 'crosswordese'
- Find words in dictionaries or match patterns on word web sites.
- Adjust theme placement and/or grid as needed
- NYT: How to Make a Crossword Puzzle, Part 3: Filling the Rest of the Grid;
How to make your entries sparkle Kevin Der and Paolo Pasco pull back the curtain
on the work that goes into filling a crossword with fun and interesting entries; 6/13/2018 - Crossword Constructor's Handbook (Berry)
Chapter 3: Choosing Good Grid Entries (And Avoiding Bad Ones); Chapter 4: Filling the Grid - The Art of Crossword Construction (Johnston): Filling the Grid
- Constructing Crosswords: Fill
4. Clues
- Generate & refine clues for clarity, difficulty, ambiguity.
- Review, revise, repeat
- NYT: How to Make a Crossword Puzzle, Part 4: Writing the Clues;
Conjuring up easy clues and clues that will twist people’s brains
Robyn Weintraub and Brad Wilber clue us in;
the submitted puzzle (before editing): clues; web, .pdf, .puz; 7/11/2018 - Crossword Constructor's Handbook (Berry) Chapter 5: Writing the Clues
- The Art of Crossword Construction (Johnston): Writing Clues
- Constructing Crosswords: Clues
5. Publish
- Submit to a publisher in appropriate format.
- Wait -- weeks/months for rejection/acceptance.
- If accepted, enjoy modest payment, fame, adulation of solvers, ...
- If rejected, submit to a different publication and/or self-publish
using puzzle formats: .pdf, .puz, web (JavaScript) - NYT: How to Make a Crossword Puzzle, Part 5: The Crossword Editors's Job; Resources
New York Times crossword editors (Will Shortz and Joel Fagliano) reveal their process
for evaluating and editing a puzzle submission; 8/17/2018 - Crossword Constructor's Handbook (Berry) Chapter 6:
Odds and Ends: Submitting Your Puzzle for Publication - The Art of Crossword Construction (Johnston): Preparing for Publication, Submitting
- Constructing Crosswords: Publish
Constructing Crosswords: Tools
Constructing Crosswords: Tools
Applications | Web-based | Dictionaries (Cruciverb, XWordInfo, ...) |
Clue Databases (cluer) | Formats (intro) | References
Applications
- These are full apps, installed on a Mac, Windows or Linux computer.
- CrossFire; Mac, Win, Lnx; $50 (one-time), free trial w/ limited functionality;
Steve uses currently [2018-];
Reference Docs; FAQ; Walkthrough [on right] - Crossword Compiler: Win; $49-$169 or subscription; updates extra;
Steve used previously on Mac, but complex/pricey setup required virtual machine,
e.g., UTM*, VirtualBox, Parallels, and possibly a Windows license
(*re-evaluating use with UTM w/ Windows ARM on a Mac M-series processor);
CrossOver Windows emulator, although simpler, produced runtime errors (last checked: 3/2024) - Ingrid; Mac, Win, Lnx; free beta version avail
- For other apps: Authoring: Apps: 'apps'
Web-based Apps
- These apps run in most web browsers -- even on some mobile devices.
- Since many of these sites are free, they're a good way to get started.
- Some sites provide publishing/distribution capability so that others can solve your puzzles,
and perhaps a social media feature for commenting on and discussing puzzles. - Examples: Crosserville, Crosshare, PuzzleMe
- For more: Authoring: Apps: 'web'
- Free-form puzzle sites, e.g., Armored Penguin -- covered earlier
Add-on Dictionaries
- Some constructors create & maintain their own lists
of entries (words and phrases). - Dictionaries overlap and vary widely in comprehensiveness and number of entries.
Some add phrases; some omit obscure or offensive words, one-off theme entries. - Entry scores suggest which entries to prioritize/prefer during fill,
e.g., lively/interesting (50-60), obscure/crosswordese (5-25). - These scores are subjective (with different scales), often customizable;
e.g., scoring guides: XWordInfo; spread the word(list); Bosivert: Collaborative Word List Project; Jones; Broda - A built-in dictionary can provide some default entries,
e.g., CrossFire's default.dict: ~183K entries, scored: 5-50 - Some constructors subscribe ($) to frequently updated, scored dictionaries/word lists,
possibly for different languages, e.g., Crossword Compiler: WordWeb Pro, add-on lists;
or entries from past/current crosswords -- next subsections: Cruciverb, XWord Info;
other word lists below are free unless otherwise noted
Cruciverb | Xword Info | spread the word(list) | Collaborative | Misc.
Cruciverb
- Cruciverb Word Lists; all.txt, nyt.txt; unscored; $39/year ('Gold');
entries: all: ~166K {1/2023}, NYT-only: ~106K; [img above]
to eliminate unusable or less-than-ideal entries that have occurred only 1-2 times,
several subsets are available: all3, nyt3 (≥ 3 times), all5, nyt5 (≥ 5 times) - CrossFire: create a .dict file (with default scores); [img right]
Dictionary > Merge Dictionaries
, e.g., all.txt
-- add own word scores or use CrossFire's db?
XWord Info
- XWord Info Word List; XwiWordList.dict; scored [5-60];
entries: ~247K {4/2024}: NYT + 134K new words; $50/year ('Angel') - Jeff Chen's special word list; scored [60]; entries: ~31K;
additional $200 (one-time) for Angel subscribers - xwordinfo: Word matching syntax: standard (?*), Regex;
Advanced Search Option; The 3 Rs of Finder: examples - CrossFire: add / rank dictionaries,
e.g., XwiWordList.dict, cruciverb_all.dict (see above);
Mac:CrossFire > Preferences > Dictionary
;
Win, Lnx:CrossFire > Edit > Configuration > Dictionary
spread the word(list)
- spread the word(list): .dict, .txt; scored [0-60]; entries: ~300K {4/2024}
Brooke Husic and Enrique Henestroza Anguiano; updated quarterly
Collaborative Word List Project
- Collaborative Word List Project: scored [1-100]; entries: ~568K {2/2023};
source; users can share scores.
Misc.
- AI, e.g., chatGPT: Authoring: Refs: AI
- American Heritage (370K)
- Peter Broda's Wordlist: .dict, .txt;
scored [1-100] or unscored versions; entries: ~427K (scored) {1/2022}; - Broda's list is large and may contain some controversial / objectionable entries. Diehl and Jones have created subsets.
- Mark Diehl's sampleWordlist: .txt; scored [40-50]; entries: ~251K {6/20/2020}; Broda subset
- Lyle Broughton Wordlist unscored
- Anagrams Sara Cantor
- Crossword Nexus: general: unscored; Famous Names: scored
- Ricky Cruz’s Personal Seed List: unscored; Ranked Wikipedia Lists
- Et Tu Etui: .txt, .dict; scored: 69; entries: ~9K {7/2021}
- Expanded Crossword Name Database: names of women, non-binary, trans, and/or people of color
as well as "places and things" (organizations, works of art, monuments etc) that represent groups/identities/people
that are often excluded from crossword grids; ~2K {11/2021} - Chris Jones; Wordlist: .txt; scored [1-50]; entries: ~170K {1/2020};
Broda subset, plus entries from NYT, WSJ, WaPo,
UKACD (UK Advanced Cryptics Dictionary), Peter Norvig's frequency counts - Juggernaut Word List (Sid Sivakumar): .txt, .dict; scored: 70; entries: ~1K {7/2021}
- Maia McC.: celebs, colleges, netspeak, nltk, queer, urbandictionary, websites
- Mirthwright Bradley wordlist: unscored
- National Puzzler's League: Collected Word Lists: .unscored?
- Ada Nicolle Seed Lists Luckystreak
- Nutrimatic: matches patterns against a dictionary of words and phrases mined from Wikipedia.
Text is normalized to lowercase letters, numbers and spaces - OED & Webster Intl. (470K)
- related words, e.g., 'dog': relatedwords.org, xwordinfo.com
- Scrabble (190K-280K)
- Brian Thomas wordlist Puzzles That Need a Home {1/2022}
Add-on clue database
- Find a clue quickly for a entry, esp. in a puzzle you won't be publishing,
or avoid overly used published clues and craft new ones. - Find out if some of your theme entries already exist in other puzzles --
entries with same date and publication? - Alternatively, manually lookup entries/clues on web sites, e.g., CrosswordTracker.com
- For offline use: Matt Ginsberg's Cluer Database App: {v3.1.5; 5/9/2023*}
Mac, Win, Lnx; free [above right]; *no longer updated; see xd.saul.pw? - Mac: ctrl-click app to Open
since it's a 3rd party app, not downloaded from App Store - cluer can also be integrated with/accessed from a construction app, e.g.,
- CrossFire (FAQ):
Clue database file
: /Applications/cluer.app/Contents/Resources/cluedata [right];
Mac:CrossFire > Preferences > General
Win, Lnx:Edit > Configuration > General
- Saul Pwanson’s database:
xd.saul.pw updated regularly vs. cluer (8/2021); xd-clues.zip
Puzzle Formats
- for print: .pdf; other options: .jpg, .png, .gif, ...
[on right: Cruciverb, Crossword Fiend: .pdf, .puz, web] - for solving and constructing apps:
most common: .puz (Across Lite);
other options: .txt (AL), .jpz, .ipuz - for web (browser-based solver applets): .js (JavaScript);
other options: .puz, .jpz -- or proprietary - next section: Formats
References
- Daily Crossword: Construction Resources
- Crossword Constructor Resource Guide
Construction Software; Online Dictionaries; Word Lists; Places to Meet Other Constructors;
Publications With Open Submission Guidelines; Other Useful Tools and Websites;
Crossword Blogs and Columns; Inspiration; Puzzle Tournaments; NYT; 11/8/2021 - How Word Lists Help -- or Hurt -- Crossword Puzzles NYT; 10/6/2021
- How the Digital Era Has Changed the Daily Crossword
puzzle design programs, word databases and web searches to help vet an answer;
some of the tools that Sam Ezersky, assistant puzzles editor, uses in his job; NYT; 12/5/2018 - How to Make a Crossword Puzzle, Part 5: The Crossword Editors's Job; Resources:
Venues With Open Submission Policies; Constructing Software; Online Resources for Finding Words and Phrases;
Word Lists; Places to Ask Questions and Get to Know Other Constructors; Crossword Blogs and Columns; NYT; 8/17/2018 - Crossword Constructor's Handbook (Berry) Chapter 6: Odds and Ends:
Useful Resources: Gridmaking software; Dictionary software; Web sites: Cruciverb, XWord Info,
Matt Ginsburg's clue database; Using online clue databases appropriately; Word Matcher;
Alex Boisvert's Crosswords; Reference sites; Books; Glossary - The Art of Crossword Construction (Johnston): Resources for Making Puzzles: Software; Grid Ideas and Word Lists; Books
- How to construct a crossword puzzle for the New York Times Alex Boisvert, Crossword Nexus; video: 9:44; resources: @8:20; 4/23/2013;
- CROSSWORDS and YOU: Search, Dictionaries; Blogs, Forums; Authoring Applications; References:Tools
Constructing Crosswords: Formats
Constructing Crosswords: Formats
Introduction |
.txt | .puz | .jpz | .js | .ipuz | .cfp | .pdf | NYT | web, CS | other |
References
Introduction
- "Today I learned that 'Across Lite' is actually...
- Different crossword file formats serve different purposes:
- formatted for printing, e.g., .pdf and image files
- structured data for construction apps, solving apps & applets, e.g., .puz, .jpz;
optional: formatting - sending puzzles to publishers -- check specifications for accepted formats
- A crossword data file contains
- grid dimensions; grid layout: locations of black squares (blocks) and solution entries;
- clues (Across and Down) -- numbering explicit, or implicit (computed from grid layout);
- usually: the solution, title, author, copyright, note to solver
- sometimes: rebus entries, squares with circles, formatting directives (square size, colors, etc.)
- Since 1996,
.puz
has been a standard crossword file format
from Literate Software (aka "Litsoft") for AcrossLite (AL)
-- and for many other solving applets/apps and construction apps. - Other file formats have been developed (e.g., .jpz, .ipuz) which would
- 1) be open standards (esp. when it appeared that Litsoft would require paid licensing)
- 2) support more flexible numbering, layout, formatting;
- -- these other formats are available, but not widespread,
perhaps since Litsoft later (v2) added .puz support for circles, rebuses,
though other features, e.g., gray squares, still unsupported: NYT occasionally recommends .pdf - 8/2021: NYT dropped support for .puz
- A few web standards & acronyms that will be referenced (Wikipedia):
- Extensible Markup Language (XML)
- JavaScript (JS)
- JavaScript Object Notation (JSON)
- Markdown
- Portable Document Format (PDF)
- A few apps do not import these public puzzle formats
-- and instead use their own proprietary file formats (which won't be covered here). - Each format below indicates possible constructing and solving apps that can open/save each format.
- Some browser applets are included also; lists and details may be incomplete/incorrect.
.txt (Across Lite: text)
.txt
: version: 1&2; Litsoft; [above: .txt excerpt]; schoOLLIfe: olli-ex.txt- most apps use the binary .puz format (next)
- Across Lite v2.5 app mentions an undocumented "v3 file format"
with support for new grid & text formatting: - Wrapping multi-line clues in clue lists that can be styled by publishers (bold, italic, underline,
forced line breaks, etc). Color emoji and expanded Unicode support. - Improved support for high-resolution monitors with high-resolution icons and
resolution-aware drawing and scaling for sharp lines and smooth text. - For printing, the grid can now be placed in any quadrant of the paper and the clues
will flow around it (previously available on Windows version only). Pick for your solving style or which hand you use. - A new custom option to include the solution grid as a separate page along
with the solving layout. This allows both solve page(s) and solution grid to be printed with a single print action.
With duplex printing, solution grid can be at the back of a single sheet to save paper. - Fonts have been updated for printing and display for newer versions of MacOS
-- to enable styled text, for better clarity in printed sheet. Spacing between clues in the print layout has been
increased and columns wider when possible to reduce number of lines for longer clues. - Dark mode can now be always enabled or never enabled or set to follow
the desktop setting in the Preferences for Layout. - Publishers can shade grid with full 24-bit color including transparency.
Emojis can be placed on grid. The shading and emojis will adjust to ensure solution entry is never obscured.
Printing preferences can disable grid marks and print shading in an unobtrusive light color/gray. - import: AL, CC, CrossFire, XWord; applet: Drupal
- export: CrossFire, Crosserville
.puz (Across Lite: binary)
.puz
; Litsoft; schoOLLIfe: olli-ex.puz- import: AL, CrossFire, Crosserville, Ingrid, XWord;
Submission Checker, PUZ to PDF Converter; NYT Submission Editor - export: AL, CrossFire, Crosserville, Ingrid
- solving apps; construction apps/sites; browser solving applets
.jpz (XML)
.jpz
: based on CC .js;
binary version of .jpz is zip-compressed;
schoOLLIfe: olli-ex.jpz- apps: CrossFire (limited import), Crosswords, Ingrid, XWord, ...;
applets: CrosswordNexus, Squares;
Submission Checker; PUZ to PDF Converter; NYT Submission Editor - JPZ Generators: .puz, .apz, ... to .jpz; docs, source
.js (JavaScript: XML embedded )
.js
: JavaScript expression (with embedded jpz XML)
used by CC applet; schoOLLIfe: olli-ex.js- apps, applet: CC -- usually CS (Crossword Scraper) compatible
- export: CC
.ipuz (JSON)
.ipuz
; wiki; xwordinfo:JSON; Puzzazz; schoOLLIfe: olli-ex.ipuz- apps: XWord, Ingrid, ...; applets: Squares;
Submission Checker; PUZ to PDF Converter; NYT Submission Editor
.cfp (CrossFire)
- CrossFire's internal format
- apps: CrossFire, Ingrid; Submission Checker; PUZ to PDF Converter; NYT Submission Editor
.pdf (Portable Document Format)
- export .pdf for puzzle & solution from most solving & construction apps
-- by generating directly from app, or by printing from app (w/ OS or 3rd party support) - schoOLLIfe: olli-ex-puz.pdf (puzzle) empty grid & clues;
olli-ex-sol.pdf (solution) numbered grid with solution - print the .pdf to solve on paper
- annotate in a PDF application, e.g., group solving over Zoom
- submit to a publisher, e.g., NYT (next)
- Crossword Nexus: PUZ to PDF Converter
- Crossword PDF Editor .puz to .pdf;
version of Crossword Nexus's Converter with some additional editing options; see also NYT Submission Editor - It's not common (or easy) to import from a .pdf into a solving app;
.pdf defines only the superficial appearance;
structured data (like .puz), i.e., grid layout, list of answers and clues, would have to be inferred. - Litzing Methods Using OCR 9/21/2012
- Crossword Scanner iOS; scan crossword puzzles from paper or screenshots into an interactive format
NYT (New York Times)
- A NYT submission is a .pdf in a specific format;
some construction apps can directly export NYT format. - NYT Guidelines, Format, Online form and Mailing address
- NYT: Sample-Submission-2020.pdf;
schoOLLIfe: olli-ex-NYT.pdf p.1 empty grid no longer required - NYT Submission Editor .puz to .pdf (NYT format);
version of Crossword Nexus's Converter with some additional editing options - export: CrossFire, Crosserville
Web
- Crossword applets might use other formats besides .puz or .js
- It's possible to convert browser crossword applets [PuzzleMe, Crossword Compiler] on some sites to
.puz, .jpz, .ipuz or .pdf by using Crossword Scraper: free browser extension Firefox, Chrome) [image: right];
e.g., NYT, New Yorker, The Week; other puzzle sites tagged with "CS" (Crossword Scraper) compatible;
source code available - PuzzleMe to .puz & .jpz: converter bookmarklets more limited than Crossword Scraper?
Other Formats
- .ccw: internal format for Crossword Compiler
- .csv: many free-form puzzle generators import text files,
i.e., each line: answer {some separator} clue - exolve (text): Exolve Player, Exet construction app
- xd (Markdown) intended to be convenient for bulk analysis of crosswords
by both humans and machines, e.g., xd.saul.pw - .xpf; XWord saves XPF with .xml extension;
superceded by .jpz, .ipuz? .schoOLLIfe: olli-ex.xml (.xpf);
apps: Crossword Composer; XWord, ...; applets: ? - .xw (JSON): Phil
- .xwc (text): Spoonbill Crossword Compiler
References
- Example (schoOLLIfe) format examples (by category): print; Across Lite; XML; JSON
- Solving Applets (in browser) [examples, gallery]
- Solving Applications [examples, gallery]
- Constructing Applications [examples, gallery]
- CROSSWORDS and YOU: Authoring:References:Formats