“Dynamic Navigation” or “In-Context Navigation” is one of my favorite features of the Adobe Community Help Client.
The Dynamic Navigation feature of the Community Help Client displays related topics based on the context of your search results.
For example, when you’re reading through a particular topic in the CFML Reference, you can quickly jump to related topics in the Developer Guide or on the web without doing a new search.
To check out this feature, follow these quick few steps.
In the Community Help Client, select ColdFusion 9 as the product.
Ensure that Community Help is selected as the search option.
Enter the search term “cfmap”, and press Enter.
- Select the first search result pointing to the CFML Reference.
You will see a Related Content tab appear at the bottom left corner of the CHC offering you links like these:
Now try out dynamic navigation for other search terms: “cfspreadsheet”, “cfsearch 9″, “cfdocument”, “cfquery 9″, “cfpresentation 9″, “cfpdf 9″.
You can also try out this feature for a few ColdFusion Builder Help topics. Select “ColdFusion Builder” as the product, ensure that Community Help is the search option, and enter any of these search terms “debugging remote applications” or “code refactoring coldfusion builder”.
Couple of things to note:
Ensure that you select an Adobe Help topic for the related content to appear. Dynamic navigation is implemented only for ColdFusion 9 and ColdFusion Builder Help topics. So, when you look-up a Help page for ColdFusion 8 or an earlier ColdFusion release, related content will not display.
This is a work-in-progress feature, so you’ll not yet find related content for all Help topics. We are, however, working towards adding related content for many of the widely-searched Help topics.
We are keen on knowing your feedback. So, do let us know how dynamic navigation works for you!
I’ve been doing a series of blog posts on the Adobe Community Help Client (CHC) since it’s been really one of the highlights of the ColdFusion Builder Beta 3 release.
In this post, I’ll focus on the Community Help Client preferences – something that I’ve figured that many people have not yet explored. The CHC provides you with many preferences to control how the Help content is displayed.
Within the CHC, select Edit > Preferences, and you can set the following preferences, as required.
- You can select a light or dark theme for the CHC. For example, when you apply a dark theme, the CHC has a dark background and theme-specific fonts.
- The CHC is launched as an AIR application, by default. You can, however, choose to launch the CHC in your web browser by selecting Open Help In Browser.
- You can specify your download preferences by selecting the products and Help packages that you want to have available for offline use. If the downloaded Help packages are up-to-date, the status shows as “current”.
- CHC provides content updates and feature enhancements without reinstalling the AIR application. Select Notify Me When Updates Are Available to be prompted for new updates when you either open or close the CHC. You can also choose to manually search and install updates.
For more information on using the CHC configured with ColdFusion Builder, see ColdFusion Builder Help System in the ColdFusion Builder User Guide.
Search is key to the Adobe Community Help Client (CHC). You can specify various search and filter options in the CHC and search across different Help packages and search locations.
Select Help > ColdFusion Builder Help to launch the Adobe Community Help Client. In the CHC, click Search Options to display the following Search locations:
Local Help – Use this option to search the Help packages downloaded to your desktop. Click Filter Results to narrow down your search results to a specific book in the Help package.
Note that you can search Local Help only if the downloaded Help packages are fully downloaded. A good way to check if the Help packages are downloaded is by going to Edit > Preferences > Local Content. The status for the ColdFusion Builder and ColdFusion docs should read as “Current”.
Adobe.com – Use this option to search for reference content across all online resources available on adobe.com, including Developer Center articles, tutorials, and knowledgebase articles.
Community Help – This search is cumulative of all the resources available on adobe.com as well as the most relevant content contributed by experts from the Adobe community.
A new Help system – Adobe Community Help Client – has been introduced in the ColdFusion Builder Beta 3 release.
Community Help Client (CHC) is an AIR application that is configured with ColdFusion Builder to provide ColdFusion Builder and ColdFusion 9 Help content. The Help content is served directly from the web. So, when you open the CHC for the first time, an Internet connection is needed. You can then download the Help content to your desktop to use and search offline.
To launch the Adobe Community Help Client, within ColdFusion Builder, select Help > ColdFusion Builder Help.
Some of the key features of the Community Help Client are:
- Up-to-date definitive reference content online and offline
- Relevant content contributed by experts from the Adobe community
- Ability to comment on, rate, and contribute to content in the Adobe community
- Content updates and feature enhancements without reinstalling the AIR application
To learn more about the Community Help Client, see http://labs.adobe.com/technologies/communityhelp/.
Some delectable news for all ColdFusion fans – especially, if you haven’t visited the Adobe Cookbooks page lately.
The Adobe Cookbooks application now has a dedicated ColdFusion Cookbook serving ColdFusion code recipes. And in less than two months, we’ve already crossed over a hundred recipes.
The ColdFusion Cookbook now makes it simple as ever to browse, view, and search for ColdFusion code recipes. If you don’t find a code recipe that you’re looking for, you can just request for that recipe. With the combined knowledge of the ColdFusion community and experts, it shouldn’t be long before the recipe you requested for is dished up.
To create or request a recipe, all you need is a valid Adobe ID. If you don’t have one, please take a few moments to register. To know additional details about the new Adobe Cookbooks application, read through this post in The ADC Blog.
So, here’s urging every ColdFusion developer out there to participate in this community application – be it by contributing, requesting, commenting, or rating the code recipes. As always, we greatly appreciate each and everyone’s participation!
Akbarsait pointed out that there’s another contest running to encourage cookbook contributions – and once a target of 200 contributions is reached, there’s going to be another drawing, with yet another chance to win more prizes! Details of the contest at Akbarsait’s blog: http://bit.ly/CFCBContest
So, what are you’ll waiting for?
In July this year, Adobe Community Publishing 1.1 beta went live.
Adobe Community Publishing System (CPS) is an AIR application that lets anyone with an Adobe ID publish content to Adobe.com.
While the Help pages support only plain-text commenting, CPS lets community members contribute tips, movies, code snippets, and more with easy-to-use templates. Contributions are moderated by community experts. Plus, everyone in the community can rate and comment on contributions.
Contributing is as simple as this:
Author your tip using a simple template.
Publish it to Adobe.com
Your contribution goes live within a few minutes, and the content is automatically added to Community Help search.
For some very useful tips to get you started with the Community Publishing app, read through Adobe Community Publishing tips.
Adobe Community Help provides a nifty custom search engine that enables you to find the best available ColdFusion resources.
You don’t have to limit your search to content produced by Adobe alone, you can search for articles, blogs, tutorials, and videos from ColdFusion community experts across the world.
The ColdFusion search engine is available from the ColdFusion Help and Support page. Or, just click here, and get started!