Publishing to SharePoint

After generating NetHelp output, you can publish it to SharePoint.

Doc-To-Help provides two ways you can publish your output to SharePoint.

  • Option 1 One option is to publish your NetHelp to SharePoint, where anyone with permissions can access it. There is no need for a special setup to post your output to the web. You can link directly to the target in SharePoint, as well as display the target in a SharePoint web part. All the NetHelp output files are published to SharePoint and accessible from index.html (the default name for the NetHelp home page).
  • Option 2 The other option is to publish your NetHelp output to a SharePoint wiki, where anyone with permissions can access and edit it. Publishing to a SharePoint wiki is another way to collaborate with your team—even your entire user community—if you wish. So this alternative is both a publishing and collaboration option.

Both options are quick and easy using the Publish to SharePoint Wizard.

The two options available from the Wizard are:

  • Upload to a SharePoint Document Library All NetHelp output files will be uploaded to a SharePoint Document Library. The files will not be altered when uploaded, but once on SharePoint, they should not be edited. If changes need to be made to the content, make them in the Doc-To-Help project, build NetHelp, and upload to SharePoint. As with any NetHelp project, the default home page for the project is index.html.

  • Upload to a SharePoint Wiki Page Library The NetHelp output will be converted to wiki format and uploaded to a SharePoint Wiki Page Library. Some formatting and functions (such as popups) will be lost because wikis do not support them. Once the NetHelp is uploaded to a Wiki Page Library, those with proper permissions may edit the content.

    Note Doc-To-Help also includes the option to share your Doc-To-Help source documents and graphics to a SharePoint Document Library. These options are useful for content collaboration, source control, versioning, and more. See Merging Word Documents.

    Note Publishing to a SharePoint Document Library is compatible with Microsoft® SharePoint® 2007 and above, as well as Office 365 (SharePoint Online); publishing to a SharePoint Wiki Library is compatible with SharePoint 2010 and above, as well as Office 365.

Before publishing NetHelp to a SharePoint Library, check the following SharePoint Library settings:

  • Web Application General Settings should be set to Permissive (the default is Strict)

  • In Versioning Settings, Require Check Out should be set to No.

Note If you change your SharePoint password after publishing outputs, you may receive an error message the next time you attempt to publish. You can fix this by clearing your Windows credentials.

  1. In Windows, open the Control Panel > User Accounts and Family Safety > Credential Manager. (This is the path for Windows 7.)
  2. Find the SharePoint Server credentials and remove them.
  3. Restart Doc-To-Help.

You will be prompted to enter your new password the next time you try to connect to SharePoint

  1. In the Doc-To-Help project, choose the Home ribbon, click the Select Target button, and choose a target.
  2. Click the Build button.
  3. Click the Publish to SharePoint button. The Publish to SharePoint Wizard opens.
  4. Click Next.
  5. Choose either Upload to a SharePoint Document Library or Upload to a SharePoint Wiki Library.
  6. Choose the SharePoint Library to which you want to upload.
  7. In the Upload Files to field, enter the SharePoint site URL. You can choose a specific folder, or create a new folder for the documents by clicking the ellipsis button and using the Select Server Folder dialog.
  8. If the folder chosen is not empty (uploading to a new Wiki Page Library will always display this message because they contain default wiki intro information), the Wizard will warn you. Click Yes to continue.
  9. Confirm your choices and click Next. The documents will be uploaded.

  10. Click Finish to close the Wizard. After the Wizard has done its work, it will display a View button.

If you uploaded to a Document Library, your NetHelp will display in a browser. The NetHelp output files are stored in SharePoint, and can be viewed by opening the Document Library.

If you uploaded to a Wiki Page Library, SharePoint will open and the NetHelp table of contents (TOC) will be displayed. Click on the TOC links to navigate the project.

When you click the View button from the Wizard, the NetHelp output uploaded to a SharePoint Document Library will open in the browser.

However, the output files/folders are in SharePoint. The index.html file (the default home page for NetHelp projects) opens the output in the browser. If you want to store your output in SharePoint and provide access to it, point users to this file.

For more information on working in a SharePoint Wiki Library, see Editing a SharePoint Wiki.