Skip to content

Documentation in the help tab #172

Closed

Description

@Tieqiong

When using pdfgui, there's the help tab we people are supposed to be able to see the user manual. However the way the package does this is to open the absolute path of the html file where the package is installed to in the browser. This path is in the doc directory, while when we build the package we only include src directory (I'm not sure for the actual release but this is the case when I install it locally). Thus users can't open the manual because it's not included when they install the package.

@sbillinge We can either include the doc directory in the setuptool build or change the approach by giving the link to the online user manual which is hopefully going to be deployed according to the new convention.

Activity

  1. sbillinge commented on Aug 20, 2024

    @sbillinge
    Contributor

    How is it done in our "cookiecutter" templates, diffpy.utils and diffpy.pdfmorph. Let's use that approach if it works.

    It seems as if example/tutorial data may have to come with the package though? Or do we want to link to it on GH?

  2. added this to the v3.1.0 milestone on Aug 20, 2024
  3. Tieqiong commented on Aug 25, 2024

    @Tieqiong
    ContributorAuthor

    No matter how we want to do this (keep the doc dir during release or link it to the online page) we want to check and change the wording on the main documentation page and readme.

  4. bobleesj commented on Sep 24, 2024

    @bobleesj
    Contributor

    @Tieqiong will fix this for 3.1.0

  5. sbillinge commented on Dec 15, 2024

    @sbillinge
    Contributor

    Can we close this?

  6. Tieqiong commented on Dec 16, 2024

    @Tieqiong
    ContributorAuthor

    I'll fix this on the 19th.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions