Document! X 2017
Authoring Content / Including Content from External Sources / Including Content from Quip Documents
In This Topic
    Including Content from Quip Documents
    In This Topic

    You can create Topics in your project that include content from Quip Documents. Including a Quip Document rather than importing it allows you to continue updating the original Quip Document; the up to date content will be downloaded and included whenever you Preview a Topic or build the documentation.

    Using Quip Documents as the source for Topics in your help system allows you to have stakeholders directly contribute content without having to install and use Document! X. Multiple users can collaborate, discuss and revise documents in Quip and the latest content will always be used whenever you Preview or Build the generated output.

    You may wish to import a static copy of the current content of a Quip Document in your project rather than using the Include method; so that you can manage the content in Document! X going forward. In order to import from Quip, first export the Quip Document to HTML using the Quip editor, and then import that Html document using the Html from file command on the Content Authoring Ribbon tab in the Topic or Content File editor.

    Importing creates a copy of the current content which can be edited in Document! X. Subsequent edits to the Quip Document will not be reflected in your project as they would if you choose to Include rather than import.

    Quip Authentication

    In order to access a Quip Document, you must specify a Quip Access Token which provides access to all documents in a given Quip account.

    If you don't already have a Quip Access Token for other purposes, you can obtain one here: https://quip.com/api/personal-token

    Once you have an Access Token you can use it as the default for any new Topics that include content from Quip by entering it on the Content Sources page in the Project Settings editor.

    Each time you generate an Access Token any previously issued Access Token is invalidated, so only do this once and keep a careful note of the Access Token, or enter it in the Project Settings page of your Project.

    If practical, it is recommended that you create a Quip account specifically for the purpose of including content so that only included documents are shared using the Quip Access Token. Using Quip, you can share documents from other Quip accounts with the "Inclusion" account for convenience but the inclusion account is the one providing the Access Token so that the documents can be accessed programatically by Document! X.

    Fundamentals

    To create a new Topic containing only content from a Quip Document

    Create a new Topic

    In the banner displayed at the top of the Topic Editor, select Quip from the drop down list.

    In the Quip Thread Id field, type the Thread Id of the Quip Document you wish to use the content from. You can find this value in the last part of the page address when you are editing a document in Quip. For example, if the address bar when editing a Quip document shows https://quip.com/NodjfUJJ then the Thread Id would be NodjfUJJ.

    In the Quip Access Token field, you can type the Access Token required in order to access this document. See the Authentication section of Including Content from Quip Documents for details on obtaining a Quip Access Token.

    It is recommended that you specify the default Access Token on the Content Sources page in the Project Settings editor; you can then leave the Access Token blank in individual Topics or Widgets that reference Quip Documents.

    Include content from a Quip Document in an existing Topic

    Open a Topic or Content File for edit.

    Position the cursor at the location at which you would like the content from a Quip Document to be included.

    On the Content Authoring Ribbon Tab, click the Widget drop down and select the Quip Document widget.

    A Quip Document Widget will be inserted.

    In the Quip Thread Id field, type the Thread Id of the Quip Document you wish to use the content from. You can find this value in the last part of the page address when you are editing a document in Quip. For example, if the address bar when editing a Quip document shows https://quip.com/NodjfUJJ then the Thread Id would be NodjfUJJ.

    In the Quip Access Token field, you can type the Access Token required in order to access this document. See the Authentication section of Including Content from Quip Documents for details on obtaining a Quip Access Token.

    It is recommended that you specify the default Access Token on the Content Sources page in the Project Settings editor; you can then leave the Access Token blank in individual Topics or Widgets that reference Quip Documents.

    In Preview and in the generated output, the latest content from the Quip Document will be included in place of the Widget.

     

     

    See Also