-
Notifications
You must be signed in to change notification settings - Fork 679
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
Referencing External Pages #63
Comments
Hi, nice to hear from you. Currently this is not possible but I see the point, something like this might be handy for long descriptions. Integrating something like this shouldn't be to complicated, we could expose a handlebars helper to do this. I'll have a look at this. |
👍 I'd love to see this too. |
Okay, currently I'm implementing it this way:
To be able to place images/documents I've also included the argument |
Great start, I really appreciate the work you're putting into this. Would it be possible to further extend this to not only inline the external documents, but also provide a way to link to external documents and view them as a standalone entity. For example we have a huge markdown file containing discussion and examples for a class as a whole. Whilst I appreciate I can inline this on the class, I'd prefer that the API for the class is still given top priority and having the ability to link over to a separate page completely for all the further discussion and examples. |
You can place the html file in the media directory and link to it using the This would be a great feature allowing you to include more detailed examples and guides within the documentation but it also raises a lot of questions and problems. How do you reach these docs, are they visible in the navigation, how are they named and sorted? I thought about giving TypeDoc the ability to load external plugins. Features like this one could be implemented as an optional plugin to TypeDoc. |
I think it'd be great if there's a way to have an index of all such external articles in front page like the one at (http://docs.sencha.com/extjs/4.2.3/#!/guide). Because there would be articles covering more than a single class, and would be nice to create a cross-reference system. |
I was thinking about this yesterday. Similar to how msdn has a Remarks section, it would be great to be able to do this. Even if there is a proper link feature, something like
It could then take a folder to search for remarks and could match on fully qualified name. This would make it easy to maintain side by side docs without maintenance of updating comments. This might be a separate feature but useful nonetheless. |
Do you mean the feature described here? If it resolves docs by qualified names, why do we need a comment tag? |
It probably doesn't need to, you're right! I guess as long as it can be On Mon, Apr 6, 2015, 13:21 Sebastian Lenz notifications@github.com wrote:
|
How is this feature going? I have a TypeScript project in which I'd like to use Typedoc to generate guides besides the reference documentation, as it seems a much simpler solution than to build a whole documentation website just for the 3 guide files I'm going to put beside the reference documentation. |
Closing in favor of #247 - on the list... probably sometime next year. |
Hey,
I have a markdown file with examples in it, and i was wondering if there was any way to reference it in the documentation. I would like to keep the file separate from the code base where possible.
Thanks.
The text was updated successfully, but these errors were encountered: