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

Improved HelpAdvisor display #12

Open
AdamsLair opened this issue Jul 21, 2013 · 8 comments
Open

Improved HelpAdvisor display #12

AdamsLair opened this issue Jul 21, 2013 · 8 comments
Labels
Editor Area: Duality editor or support libraries Feature It doesn't exist yet, but I want it Help Wanted Contributions especially appreciated Nice2Have Beneficial, but only very slightly so Usability Related to API and UI usability
Milestone

Comments

@AdamsLair
Copy link
Collaborator

@youssefMansour
Copy link

Hi
I want to help. I'm newbie with duality and opensource.
Would you like to support me?
thanks :)

@AdamsLair
Copy link
Collaborator Author

Hi youssefMansour,

I'm glad you like Duality and are willing to help. Although I'm quite busy right now and thus can't give you a personal guide into both Duality and contributing, there is already a little bit of documentation available on how to use Duality and how to help. If you're new to Duality, working on actual issues is not the right spot to start, but there are a lot of other ways to help that are definitely appreciated as well!

If you need additional support, feel free to join the community, present your work and get in touch with others. :)

Regards,
Adam

@AdamsLair AdamsLair added this to the General Improvements milestone Nov 6, 2014
@Xinayder
Copy link
Contributor

Xinayder commented Dec 5, 2015

Alright, I gave it a look a few months after my last comment (which contained wrong information now that I correctly tested it), and the way Duality "renders" the help text prevents HtmlRenderer from working.

What you'd need to do is either:

  • a) Pass the topic and description values to labelTopic and labelDescription;
  • b) Render the HTML in the OnPaint method

In case letter B is chosen, you should consider markdown rendering instead of HTML (or support both). Markdown for the win!

@ilexp
Copy link
Member

ilexp commented Dec 6, 2015

In case letter B is chosen, you should consider markdown rendering instead of HTML (or support both). Markdown for the win!

The more I think about it, the more I prefer markdown as well. There are probably some good markdown renderers out there for .Net as well.

An additional requirement will be properly displaying C# XML comment markup, since most help advisor texts are generated from them. For keeping compatibility with Visual Studio and reference generators, XML comments will be required to use their own markup and unable to use markdown syntax. The advisor could then convert them to markdown before parsing it, not a problem - however, a consequence would be that the only way users could truly enter markdown help texts is for custom help advisor topics.

Probably not as awesome as one might think when reading "markdown support for help advisor text", but still :)

@SirePi
Copy link
Member

SirePi commented Mar 23, 2020

Been playing around a bit, but I might need some help from @ilexp for dealing with external dependencies
image

@ilexp
Copy link
Member

ilexp commented Apr 4, 2020

Looks neat 👍 What do you need?

@SirePi
Copy link
Member

SirePi commented Apr 5, 2020

Initially I was thinking about having to deal with external dependencies, and how to make them go in the Plugins directory on build but, if #786 goes through, maybe there is no more need for this.

Just in case though, is there something needed, or does it happen automatically if the plugin sits in a nuget package? been a while since I last did an editor plugin 😄

@ilexp
Copy link
Member

ilexp commented Apr 9, 2020

If you bundle the dependencies directly in your package, they will be treated the same as the package itself and will go in the Plugins folder - which is fine and should work. If you link them as a dependency of your package, it depends on how that package is tagged. If it's a regular library, it will go to the root folder, if it's a Duality plugin, the same applies. Both cases are supported. If you're interested, this is where to look for the implementation.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Editor Area: Duality editor or support libraries Feature It doesn't exist yet, but I want it Help Wanted Contributions especially appreciated Nice2Have Beneficial, but only very slightly so Usability Related to API and UI usability
Development

No branches or pull requests

4 participants