Snippets are pre-set chunks of formatted content that authors often insert into topics. You can think of them as miniature topics within topics. They can be formatted just like a topic and they look like they are part of the regular content in a topic, but they are not; they are separate files.
If you open a document that contains a snippet, you'll be able to identify the snippet in a couple of ways:
- You cannot click inside the snippet to edit it. That's because the snippet content is held in a separate snippet file. So if you cannot click in some content to edit it, chances are that it's a snippet.
If you have markers turned on (by clicking the down arrow next to in the local toolbar and selecting Show Markers), a snippet marker is represented by brackets.
Following are tasks associated with snippets. The action that you can perform depends on the workflow.
- Create Snippets From Content (New Document Workflow) If you have already added content in your document and want to turn that content into a snippet, you can create a snippet out of that existing content using the Home ribbon or Format menu. The snippet has an .mcsnp file extension and can be saved anywhere you like. See Creating New Snippets from Existing Content.
Insert (New Document and Contribution Workflows) You can insert snippets into a document. See Inserting Snippets.note
Note: You can also create nested snippets (i.e., a snippet within a snippet). To do this, simply open a snippet and then insert another snippet into it.
Open (All Workflows) If an author sends you a review package that includes snippets, they can be seen in the Review Packages window pane. You'll be able to identify a snippet because it has an .flsnp file extension, whereas topic files have an .htm extension. You can double-click a snippet file in the grid and it opens in the XML Editor, just as a topic does. This is one way to open snippets when using the Review workflow.
Another way to open snippets pertains not only to the Review workflow, but to all workflows. In the document where the snippet has been inserted, right-click on the snippet and select Open Link. See Opening Snippets.
- Edit (Review—Registered, Contribution, and New Document Workflows) After you open a snippet, you can make changes to it in the XML Editor. See Editing Snippets.
Note: Although it is possible to open any Contributor files in a third-party editor, it is recommended that you avoid editing these files in certain programs while Contributor is running. For example, opening a stylesheet in Notepad is not an issue. But you might experience problems if you open a topic or snippet in Microsoft Word and edit it while Contributor is running.