Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Intersphinx linking to properties not working #27

Open
DominicDirkx opened this issue Nov 5, 2021 · 8 comments
Open

Intersphinx linking to properties not working #27

DominicDirkx opened this issue Nov 5, 2021 · 8 comments
Assignees
Labels
documentation Improvements or additions to documentation

Comments

@DominicDirkx
Copy link
Member

As discussed in the first couple of posts in #25:
#25 (comment)
we currently have no way of using intersphinx to use links to the tudatpy API docs for class properties. This should be resolved to allow full linking between tudat-space and API docs. Since properties are usually mentioned in the context of the linked class that they belong to, this issue does not have high priority

@FilippoOggionni FilippoOggionni added the documentation Improvements or additions to documentation label Nov 5, 2021
@FilippoOggionni
Copy link
Member

The same problem happens for modules. I tried with :mod: but it does not work.

@DominicDirkx
Copy link
Member Author

That's weird, I hadn't tried that yet. If we don't manage to resolve this soon-ish, we could put in direct URL links, pending the resolution of this issue, as a temporary working solution

@FilippoOggionni
Copy link
Member

I agree. Let's see if we can get @ggarrett13's view on it in the next few days, otherwise I agree on temporarily switching to regular URL links for now

@geoffreygarrett
Copy link
Member

Apologies for the late reply. I saw the original thread in #25 and saw it closed, did not see this one.

links to the tudatpy API docs for class properties

I don't think there is a solution for linking directly to a class' properties. The following approach may be a good alternative:

... as determined by property_X of :class:Class_X

Where the latter is linked and former is not.

@geoffreygarrett
Copy link
Member

Actually, I found this. I don't know if it works only within the same project, or if it works for linking to external projects. Give it a go, but I consider this issue closed.

@FilippoOggionni
Copy link
Member

The link posted by @ggarrett13 unfortunately does not solve the issue. While the workaround for properties holds, this does not work for modules (neither :mod: nor the generic :obj: tags work).

@FilippoOggionni
Copy link
Member

Potentially useful material: see this comment

@FilippoOggionni
Copy link
Member

Resource

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

No branches or pull requests

3 participants