Skip to content

Commit 480513c

Browse files
authored
File menu (#583)
* Add files.md to describe the File menu move the Printing section from editing.md to files.md added the missing 'Open in Default Viewer' to the other-resources tab-bar right-click section * quick updates per Alan - move "Printing" after the "File Menu" - notes about **Reload from Disk** resetting bookmarks, token highlighting, and change history, all of which have come up in the forum before. * add files.md to README
1 parent da50320 commit 480513c

File tree

4 files changed

+72
-3
lines changed

4 files changed

+72
-3
lines changed

README.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,7 @@ Summary
77
=======
88

99
* [Getting started](content/docs/getting-started.md)
10+
* [Working with Files](content/docs/files.md)
1011
* [Editing](content/docs/editing.md)
1112
* [Searching](content/docs/searching.md)
1213
* [Views](content/docs/views.md)

content/docs/editing.md

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -243,6 +243,4 @@ But with so many commands, and the fact that no documentation set is likely to e
243243

244244
## Printing
245245

246-
The **File > Print** action will pull up a Windows-standard print dialog, from which you can choose your printer and send your text to the selected printer. Normally, it will print the whole document, but you can use the print dialog to choose only certain pages; if you have an active selection in the editor, only the selected text will be printed.
247-
248-
The printing of the text is affected by the [**Settings > Preferences > Print**](../preferences/#print) settings, where you can decide things like whether or not to include line numbers in the printout, margin widths, extra text to print in the header and/or footer of every page, and the **Colour Options** will determine how your [Style Configurator theme's colors](../preferences/#style-configurator) will be propagated to the printed output. It is up to you as the user to decide which printing settings are best to meet your needs, and will look best on your printed medium of choice. Please note that with any themes with colored backgrounds, some of those colors will be printed to the background of your printed page unless you choose one of the **Colour Options** that does not print the background color; but with darker themes, which use light text on dark backgrounds, if you _don't_ have it print the background color, then it will be very light text on your white paper. If you have a printer which allows you to print to PDF, that is a good way to see what the printout will really look like without using the paper and ink (and if you don't have a PDF printer available, your favorite search engine will show you plenty of commerical and freeware PDF printers by searching for something like "windows pdf printer" or "print to pdf").
246+
_The documentation on printing the active document has been moved to [Working with Files > Printing](../files/#printing)._

content/docs/files.md

Lines changed: 69 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,69 @@
1+
---
2+
title: Working with Files
3+
weight: 9
4+
---
5+
6+
# Working with Files
7+
8+
A "file" is the basic unit of what is edited in Notepad++, but that term actually covers multiple related concepts. Primarily, the "file" is the series of bytes stored on a disk or other storage medium and accessed through your computer's filesystem; and pedantically, if the document you are editing has never been saved to the filesystem, it's not technically a file, though common usage applies that term to unsaved documents as well. The "document" refers to the text being edited, whether it's a new, unsaved document, or whether it's a document that's been previously saved as a file on the filesystem. And finally, in Notepad++, each document is presented in a [Tab](../other-resources/#tabs) in one of the two [Views](../views/) of the Notepad++ user interface, which are the graphical containers which Notepad++ uses to manipulate files and other documents, though many users think of the user interface element as the "file" as well.
9+
10+
## File Menu
11+
12+
The **File** menu contains many of the normal file-operation actions found in most applications. Notepad++ also includes other custom actions which are useful to understand.
13+
14+
- **New**: Creates a new document, and displays that empty document in a Tab in the active View.
15+
- **Open**: Opens an existing file from the filesystem, and displays that document in a Tab in the active View.
16+
- **Open Containing Folder >**:
17+
- **Explorer**: Opens an instance of the Windows Explorer, starting in the folder (also known as the "directory") which contains the active file.
18+
- **cmd**: Opens an instance of Windows' `cmd.exe`, starting in the folder which contains the active file.
19+
- **Folder as Workspace**: Opens the active file's folder in Notepad++'s [Folder as Workspace](../session/#folder-as-workspace) panel.
20+
- **Open in Default Viewer**: This will make use of the Windows "filetype association" for the active file (based on the file extension).
21+
- It does the equivalent of double-clicking on a file in Windows Explorer.
22+
- If the document has never been saved as a file, this action will be grayed out and the menu entry cannot be used.
23+
- If the filetype has no associated default action in Windows, this action will be grayed out and the menu entry cannot be used.
24+
- If the filetype is associated with Notepad++, and would thus just re-open the file in Notepad++, this action will be grayed out and the menu entry cannot be used.
25+
- **Open Folder as Workspace**: Opens the active file's folder in Notepad++'s [Folder as Workspace](../session/#folder-as-workspace) panel.
26+
- **Reload from Disk**: This will re-read the bytes of the file from the filesystem, replacing the current contents of the documented being edited with the last-saved version (and thus losing any changes that might have been made in Notepad++).
27+
- If you have [**Settings > Preferences > MISC > File Status Auto-detection**](../preferences/#misc) turned on, you Notepad++ can automatically run the equivalent of this command for you, without you having to use this menu entry.
28+
- Any [bookmarks](../searching/#manipulating-bookmarks) or [token styling](../searching/#marking-with-a-color-style-and-highlighting) that you previously had set will be cleared.
29+
- Any [change history](../editing/#change-history) recorded for the file will be reset, and the file will appear with no change-history margin colors.
30+
- **Save**: Saves the current document to the filesystem using the same filename.
31+
- If the document does not currently have a file associated with it, this action will be grayed out and the menu entry cannot be used. Use **File > Save As** instead.
32+
- **Save As**: Saves the current document to the filesystem, prompting for the new filename to use.
33+
- If the document had previously been saved to a file, this will create as new copy of the file, and Notepad++ will continue working with the document associated with the new file, leaving the old file with the contents that were last saved.
34+
- **Save a Copy As**: Saves the current document to the filesystem, prompting for the new filename to use.
35+
- The new file will be saved, but Notepad++ will continue to work with the document associated with the original filename. So this action effectively creates a backup of the file, but allows you to continue working with the previous file, whereas **Save As** uses the original as the back and allows you to keep working with the new file.
36+
- **Save All**: Saves all documents that are currently open in either of Notepad++'s two Views.
37+
- **Rename**: Prompts for a new name to give to the current document.
38+
- If the document is associated with a file, Notepad++ will open a standard Windows dialog to save the file under a new name on the filesystem, and the old filename will no longer exist.
39+
- If the document is a new, unsaved document, it will change the name displayed in the Tab for the current document. If you later do a **Save As**, it will use that as the default suggested name in the **Save As** dialog.
40+
- **Close**: Closes the active document, prompting to save if it has been modified since it was opened or created.
41+
- **Close All**: Closes all the documents that are open in the current instance of Notepad++, prompting to save if one or more files has been modified since they were opened or created.
42+
- In the prompt dialog, **Yes** will save the file, **No** will close it without saving (you will _lose_ any changes), **Cancel** will stop Notepad++ from closing all the files.
43+
- If there are multiple files that you are prompted for, you will also get **Yes to All** to save all changed files, and **No to All** to lose changes from all changed files.
44+
- **Close Multiple Documents >**:
45+
- **Close All but Active Document**: Closes all open documents, except the document that is actively being edited.
46+
- **Close All to the Left**: Closes all the open documents that are to the left of the active document on the current View's tab bar.
47+
- **Close All to the Right**: Closes all the open documents that are to the right of the active document on the current View's tab bar.
48+
- **Close All Unchanged**: Closes all open documents that have not been edited since they were last opened or created.
49+
- **Move to Recycle Bin**: Closes the active document, and moves the underlying file to the Windows Recycle Bin. If the document has no underlying file, this action will be grayed out and the menu entry cannot be used.
50+
- **Load Session...**: Loads all the files from a saved [Session file](../session/#sessions).
51+
- **Save Session...**: Saves the current session (list of opened files) to a [Session file](../session/#sessions).
52+
- **Print**: Opens a **Print** dialog to print the file, as described in the [Printing](#printing) section.
53+
- **Print Now**: Prints the active file without showing the **Print** dialog, using the default printer and other default settings of the **Print** dialog.
54+
- **Recent Files >**: The list of recently-closed files that Notepad++ has edited.
55+
- If [**Settings > Preferences > Recent Files History**] is set to use a sub-menu, the recent files will be in that sub-menu, otherwise they will be in the main **File** menu.
56+
- Clicking on a file entry will open that file.
57+
- **Restore Recent Closed File**: Opens the file that was most recently closed, which is at the top of the list of Recent Files.
58+
- **Open All Recent Files**: Opens all the files from the list.
59+
- **Empty Recent Files List**: Removes all the files from the Recent Files list.
60+
- **Exit**: Closes the Notepad++ application.
61+
- If you have [**Settings > Preferences > Backup**]() `☑ Remember current session for next launch` checkmarked, Notepad++ will save the current list of files to the session. The only files that will be remembered for the next launch of Notepad++ will be those files that are currently open in Notepad++.
62+
- If you do not have [**Settings > Preferences > Backup**]() `☐ Enable session snapshot and periodic backup` checkmarked, Notepad++ will prompt you whether to save any files that have been changed, following the same rules as **Close All**, described above. If you do have that setting checkmarked, unsaved documents will also be included in the session file even if they don't have an underlying file.
63+
64+
## Printing
65+
66+
The **File > Print** action will pull up a Windows-standard print dialog, from which you can choose your printer and send your text to the selected printer. Normally, it will print the whole document, but you can use the print dialog to choose only certain pages; if you have an active selection in the editor, only the selected text will be printed.
67+
68+
The printing of the text is affected by the [**Settings > Preferences > Print**](../preferences/#print) settings, where you can decide things like whether or not to include line numbers in the printout, margin widths, extra text to print in the header and/or footer of every page, and the **Colour Options** will determine how your [Style Configurator theme's colors](../preferences/#style-configurator) will be propagated to the printed output. It is up to you as the user to decide which printing settings are best to meet your needs, and will look best on your printed medium of choice. Please note that with any themes with colored backgrounds, some of those colors will be printed to the background of your printed page unless you choose one of the **Colour Options** that does not print the background color; but with darker themes, which use light text on dark backgrounds, if you _don't_ have it print the background color, then it will be very light text on your white paper. If you have a printer which allows you to print to PDF, that is a good way to see what the printout will really look like without using the paper and ink (and if you don't have a PDF printer available, your favorite search engine will show you plenty of commercial and freeware PDF printers by searching for something like "windows PDF printer" or "print to PDF").
69+

content/docs/other-resources.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -114,6 +114,7 @@ When you right click on the title for a tab, you get a context menu for manipula
114114
- `Open Containing Folder in Explorer`: Opens this file's folder in the Windows Explorer
115115
- `Open Containing Folder in cmd`: Opens this file's folder in the `cmd` command prompt
116116
- `Open Containing Folder as Workspace`: Opens this file's folder as a [Folder as Workspace](../session/#folder-as-workspace)
117+
- `Open in Default Viewer`: Opens this file in the default Windows, using the same rules as the [**File > Open in Default Viewer** menu action](../files/#file-menu).
117118
- `Rename`: Renames this file
118119
- `Move to Recyle Bin`: Deletes the current file (placing it safely in Window's Recycle Bin)
119120
- `Reload`: Reloads this file from disk

0 commit comments

Comments
 (0)