diff options
| author | Norbert Preining <norbert@preining.info> | 2024-08-06 03:01:14 +0000 |
|---|---|---|
| committer | Norbert Preining <norbert@preining.info> | 2024-08-06 03:01:14 +0000 |
| commit | b0bf44f89c03c433fb7e9733f24a28a729a80121 (patch) | |
| tree | 1a136df9919c1488b41d73c91118bf5c3c383f28 /support | |
| parent | f0d5386b8d7fba4c439e10a541c86deeccb14a18 (diff) | |
CTAN sync 202408060301
Diffstat (limited to 'support')
| -rw-r--r-- | support/texshop/README.txt | 2 | ||||
| -rw-r--r-- | support/texshop/texshop536.html | 64 | ||||
| -rw-r--r-- | support/texshop/texshop542.html | 86 |
3 files changed, 87 insertions, 65 deletions
diff --git a/support/texshop/README.txt b/support/texshop/README.txt index f8c0d70436..5c17bd2662 100644 --- a/support/texshop/README.txt +++ b/support/texshop/README.txt @@ -7,4 +7,4 @@ The main author is Richard Koch, koch@uoregon.edu, with supporting contributions Consult the program web site, https://pages.uoregon.edu/koch/texshop/texshop.html, for full source code, an extensive Changes document, and other information. -The current version, 5.36, was released on May 26, 2024.
\ No newline at end of file +The current version, 5.42, was released on August 5, 2024.
\ No newline at end of file diff --git a/support/texshop/texshop536.html b/support/texshop/texshop536.html deleted file mode 100644 index 705e6546b3..0000000000 --- a/support/texshop/texshop536.html +++ /dev/null @@ -1,64 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - -<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> -<head> - <title>TeXShop</title> - <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> -</head> - -<body> - - -<!-- main content --> -<div id="main"> - -Version 5.36 has one minor bug fix and a major improvement of the PageNumber correction introduced in version 5.35. -<ul> -<p><li> In a document with over a thousand pages, the PageNumber box in the toolbar displays the number with a comma, as in 1,325. But users who want to go to a different page must enter the new page number without a comma. This makes it impossible to edit the existing number, say by changing 25 to 17 to go to page 1,317. This is fixed. -<p><li> Suppose a document has several pages of preliminary material before the main text begins. Perhaps these preliminary pages are numbered i, ii, iii, iv, v, ... and the main pages are numbered 1, 2, 3, 4, 5, ... Then entries in the PageNumber box will not be in sync with the actual page numbers in the text. The previous version of TeXShop introduced a fix for this problem, which required the user to insert a magic comment line and manually indicate the number of preliminary pages. The fix then numbered the preliminary pages 1#, 2#, 3#, ... and the main pages 1, 2, 3, ... -Moreover, users could enter a number like 17 in the box to go to main page 17, and 2# in the box to go to the second preliminary page. - -<p> This fix is still present in TeXShop 5.36, but the method of turning it on has been supplanted by a better method which does not require a magic comment line. The new method adds a macro to the source file which inserts an extra line in the console output and log file -during typesetting. That line reads "Start of main material: 3." Here 3 is replaced with the page number of the first main page. TeXShop looks for this line during typesetting; if it occurs, the PageNumber is modified as in the old method. A big advantage is that as the preliminary material grows during editing, the fix automatically adjusts without user intervention. - -<p> To activate this fix when using LaTeX and related engines, add the line -<pre> - \write128{Start of main material: \the\ReadonlyShipoutCounter.} -</pre> -to a spot in the source just after the main material is introduced. - -<p> If instead you are using plain TeX or related engines, add the line -<pre> - \write128{Start of main material: \the\pageno.} -</pre> -to a spot in the source just after the main material is introduced. - - -<p> TeXShop users need to find a way to remember these additional lines. Some may add items to the Macro -menu, while others may modify their templates. It is also possible to add appropriate items to the Command Completion dictionary. - -<p> After these lines have been added to the source, it is necessary to typeset to see changes in the PageNumber box. A lot of effort has gone into modifying the PageNumber whenever appropriate information is available in the log file. When TeXShop opens a new document, it checks to see if a log file is present, and if so it reads the log file to adjust the PageNumber box. If TeXShop is closed while documents are open, the documents will reappear the next time TeXShop starts with correct PageNumber entries. - -<p> Suppose a situation I did not anticipate causes the new code to crash the program when reading an old document, even when the extra lines above have not been added to the source. In that case, write me immediately and I'll fix the problem. But in the meantime, you can fix the crash. Add the magic comment below to the top of the source. This comment completely cancels all of the new code, and the number 0 in the comment tells it to make no changes in the numbering. -<pre> - % !TEX numberingCorrection = 0 + current - desired -</pre> - -<p> Fixing Page Number boxes is a standard feature of pdf display programs like Preview, Skim, and Adobe Acrobat. These programs do not have access to the source file, and often work by parsing the table of contents information in the pdf file. TeXShop is a program for authors rather than a pdf display program, so it is natural for it to find the information to fix the Page Number box in the source file. - -<p> Some users may prefer to view pdf files in TeXShop. If these users have access to the Log file associated with the pdf, they can get Number Box correction without using the source file. Just place the Log file in the same location as the pdf file, and TeXShop will automatically open and parse it, and adjust Page Numbers accordingly. - -<p> This feature is even available if you do not have access to the Log file. For example, the Driver Manual for my car is a pdf file with two preliminary pages and then the main pages numbered 1, 2, 3, ... Using Apple's Text Edit in plain text mode, I created a small file with the same name as the pdf manual, but extension ".log". The complete contents of this file were -<pre> - Start of main material: 3. -</pre> -After this file was placed in the location of the manual, opening the manual in TeXShop provided PageNumber boxes with the correct numbering. -</ul> - -<p> -<p> -</div> - - -</body> -</html>
\ No newline at end of file diff --git a/support/texshop/texshop542.html b/support/texshop/texshop542.html new file mode 100644 index 0000000000..990aec54dc --- /dev/null +++ b/support/texshop/texshop542.html @@ -0,0 +1,86 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> + +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> +<head> + <title>TeXShop</title> + <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> +</head> + +<body> + + +<!-- main content --> +<div id="main"> + +Versions 5.37 - 5.41 were never released. Version 5.42 has seven small changes and one major additional feature: +<ul> +<p><li> Recall that version 5.36 fixed a bug reported by Hans Schoutens which surfaced when his document reached a length of 1000 pages. His Page Number box displayed the number with a comma, writing for instance 1,213. In that case, it was not possible to use the box to go to page 1,209 by just changing the last two digits, because TeXShop ignores all numerals after the comma. I fixed this problem by removing all commas in the box before using the number to go to another page. +<p>Shortly after making this fix, a similar complaint came from Emilio Faro Rivas. But in his country, periods are used to separate groups of three digits, and commas are used to set off the fractional part of a number. So while I would write 1,213.74, Rivas would write 1.213,74. + +<p> In the Language & Region control panel, Apple provides four different ways to determine how numbers are written. Since page numbers cannot have fractional part, TeXShop now removes all commas and periods from the Page Number box before interpreting the number. + +<p> Learning of two books with more than 1000 pages in the course of a couple of days reminded me of the English critic who met Edward Gibbons after skimming through the volumes of the Decline and Fall of the Roman Empire, and said "always scribble, scribble, scribble, eh Mr Gibbons.'' +<p><li> Version 5.42 fixes a bug reported by Juan Luis Varona Malumbres. In TeXShop Preferences under the Misc2 tab, there is an item reading "During File Save, Automatic UTF-8-Mac to UTF-8 Conversion", but this item no longer worked. I checked back to TeXShop 5.18 and the item was already broken then. The ultimate cause is embarrassing. TeXShop's code interpreting a change in this preference read as follows +<pre> + 1) Remember the old Conversion value so we can undo if the user clicks "Cancel" rather than "OK" + 2) Activate the font panel for the Console Font. + 3) Modify the Console Font if the user chooses a new font. +</pre> +Huh? It turns out that sometime in the past, a mistaken copy and paste operation replaced the rest of the +code for Conversion with pieces of code for the Console Font. Miraculously, that bad code still compiled, and +caused no problems when the Preference Panel ran except that the Conversion item no longer worked. The misplaced Console code also existed in its regular spot, where it did what it was supposed to do. The bad code was removed and the original code was reinserted. Problem fixed. +<p><li> Peter Smith requested that the keyboard shortcut command-T also apply if an Experiment window is open, and typeset for that window rather than for the entire document. Done. +<p><li> If TeXShop opens the Log file of a project, a header at the top allows users to filter the contents of the log file based on various criteria, showing for instance all warnings, or all underfull boxes. This feature was added to TeXShop twenty years ago, and I had completely forgotten how it works. It turns out that texloganalyser is a perl script +by Thomas van Oudenhove, which he has maintained over the years. This script is in TeXLive, and TeXShop + calls the script to parse. Thanks, Thomas van Oudenhove, after all these years! + <p> This script does not have an option to print only error messages. But error messages in files typeset by TeXShop leave an easy-to-recognize trace in the log file due to the flag "-file-line-error" added by default in Preferences. + TeXShop already uses this trace to implement Goto Error. So an extra button has been added to the header when TeXShop displays Log Files allowing users to search for error messages. + <p><li> TeXShop can now open, write, and edit .adoc files. This was requested by Richard Bennett, who wrote that he is transitioning to using the asciidoc format and wanted to edit such files in TeXShop. + <p><li> In languages like Spanish, many words begin with "part", so using "part" as a trigger word in the Tags menu leads to incorrect items. This problem is fixed by changing the trigger to "part{". + <p><li> Finally, a comment about the PageNumber correction system introduced in versions 5.35 and 5.36 + of TeXshop. Large documents often begin with preliminary pages, numbered with Roman numerals. After that, the main pages begin, with numbering starting at page 1. But then the page number in the TeXShop Page Number Box does not agree with the actual page number shown in the document. +<p> Version 5.36 provides an easy fix by asking the author to add just one line of source code. After the fix, TeXShop reports preliminary pages as 1#, 2#, 3#, ..., and then regular pages as 1, 2, 3, ... +<p> To activate this fix when using LaTeX and related engines, add the line +<pre> + \write128{Start of main material: \the\ReadonlyShipoutCounter.} +</pre> +to a spot in the source just after the main material is introduced. + +<p> If instead you are using plain TeX or related engines, add the line +<pre> + \write128{Start of main material: \the\pageno.} +</pre> +to a spot in the source just after the main material is introduced. +<p> Alan C. Bowen pointed out that the fix also works in ConTeXt, and in that case the line to add is +<pre> + \write128{Start of main material: \the\realpageno} +</pre> +<p><li>The new feature is that TeXShop can now annotate pages of a pdf document. +See the "Annotation" chapter of the TeXShop manual for details. +<p> It has always been possible to annotate pdf files created by TeXShop using a third party program like Preview, Skim, Adobe Acrobat, etc. The resulting annotated file can be opened in TeXShop and displayed alongside the +original source and preview windows. So an author can write a paper in TeXShop, send the pdf output to an editor to be annotated in Adobe Acrobat, open the annotated version alongside the regular version in TeXShop, and revise as needed. All of this is possible in earlier versions of TeXShop because Apple's PDFKit supports annotation. This use pattern is likely to remain standard in the future because the listed programs and many others have sophisticated annotation capabilities. +<p> TeXShop 5.42 provides only a subset of easy to use annotations, but these may be +helpful for those just starting to annotate, or if one author is creating both a manuscript and the annotated version +at the same time. +<p> The new feature has been added in a nonintrusive manner. No new tools were added to the toolbar, no new code runs in standard mode, and the only difference a regular user will notice is a new item in the Preview menu called "Annotation Panel". +The ability to annotate in TeXShop may not change authors' working habits, but it was a fun summer project for me. + +<p> For those who don't read the manual, here's a short survey. The annotation panel contains all tools needed to annotate. Switch between Edit mode and Run mode at top left. Annotations are created, moved, resized, and modified in Edit mode. They are fixed in Run mode. Create new annotations by clicking on the picture of the annotation in the panel. For instance, select some text and then click strikeout to strike out the text. Emphasize and underline work the same way. + +<p> For other annotations, select some pdf text and click on a picture in the panel to make an annotation appear near the text selection. Or just click the picture and the annotation will appear at bottom left. Drag and resize annotations +after creation. To change annotation colors, open the Color Panel, +select an annotation, and then select a color. One annotation shows text on a colored background. Change the background color as above, and hold down the option key while selecting a color to change the text color. +To change the fonts in annotations with text, open the Font Panel, select an annotation, and change the font in the panel. To modify the text in annotations with text, open the Text Panel and edit the copy of text it contains. + +<p> Popups are annotations that look like a small icon, often in the document margin. In Run mode, clicking on this icon opens a panel of scrollable text. The font and color of this text cannot be changed; to change the background color, change the color of the icon. To insert text in a popup during Edit mode, click on the icon while holding down the option key to reveal the editable panel of text. + +<p>A special note of thanks to Uwe Schmock, who was helpful with both program design and the manual pages during work on Annotations. He has a list of further desirable changes, but eventually I cried "enough." +</ul> + +<p> +<p> +</div> + + +</body> +</html>
\ No newline at end of file |