Little Known Things about the Eclipse Infocenter: Deep Linking (2/5)

September 17, 2014

The Eclipse Infocenter is the Eclipse help system launched as a stand-alone web application. Five well-hidden features about the Infocenter will be presented one after the other here. Basic and Bot Mode have already been presented and here comes the second little known thing: deep linking.

The Infocenter does not yet support deep linking: When you browse inside the Infocenter the URL does not change. If you want to bookmark a topic you will have to copy the topic link via right-click menu from the table of contents, paste the link into the address bar and bookmark this URL.

Deep Linking

VMware has already implemented deep linking without contributing it back to Eclipse. This is not the only adaption VMware made. Unfortunately, one of these additional adaptions does not work with Internet Explorer 8 (in contrast to Firefox, Google Chrome and Internet Explorer 11), so that the table of contents does not show up. There are no such problems with the plain Eclipse Infocenter. This is why contributing back makes sense. 😉

However, deep linking has not yet been implemented in the plain Eclipse Infocenter and you have to copy manually the link from the table of contents. This link is redirected to the version with HTML frames. If you want to see the topic framelessly without the table of contents, search field, etc. you will have to append ?noframes=true to the link. Alternatively, in the URL you could replace /topic/ with /nftopic/ or – if you want to have the navigation breadcrumb at the top – with /ntopic/.

With the resultof parameter you can highlight text. The topic is automatically scrolled to the first hit. This can be used to link to a specific section inside a topic. For example, if you want to link to the “Dark theme” inside the “What’s New in Luna” topic you will have to append ?resultof=”Dark theme” to the link. The phrase to be highlighted has to be enclosed in parentheses. Two or more phrases have to be concatenated without delimiters as you can see in the following example:

Highlighting via 'resultof'

To combine both frames and highlighting is a little bit tricky. First you have to open the topic link which redirects you to index.jsp?topic=…; then you have to append ?resultof=… to the redirected URL. The ?topic=…?resultof=… instead of ?topic=…&resultof=… is probably a work-a-round for an error waiting to be fixed. 😉

The next little known things about the Eclipse Infocenter on my list are Search Links, Language Switching and Debugging Information. Stay tuned!

Flattr this

Little Known Things about the Eclipse Infocenter: Basic and Bot Mode (1/5)

September 12, 2014

The Eclipse help system can also be launched as a stand-alone web application, the so-called Infocenter. The Eclipse Infocenter is widely used by several companies and organizations, with and without adaptions. Although many of you will be familiar with or one of these websites, hardly anyone will know all of the five well-hidden features of the Infocenter that might be useful to you. They will be presented individually here. And here comes number one: the basic and the bot mode.

When you visit the Infocenter with a very, very, very old web browser such as the Internet Explorer 5.5 or Netscape Navigator 4.8 the website looks different than with any web browser that was released in the last twelve years. This so-called basic mode (in contrast to the advanced mode for current browsers) exists mainly because these old browsers do not support JavaScript callbacks. For instance, if you click on a book in the table of contents, the table of contents HTML frame will be replaced by a new HTML page in which the whole subtree of the clicked book is expanded. This is realized simply by HTML links. In the normal advanced mode the chapters of the next level are asynchronously loaded via JavaScript without leaving the page.

Eclipse Luna Help in Basic Mode

The basic mode can also be useful with a current browser. For example, if you need the whole table of contents of a book then it can be easily extracted (and copied) from /basic/tocView.jsp. This saves you manually expanding every individual chapter.

In the Infocenter, the browser detection to switch between basic and advanced mode is done via the User-Agent HTTP header field. The User-Agent field is also used to present the website without HTML frames to web crawlers in a third mode, the bot mode. For the Google Search Bot the Luna Help with its 17,875 topics looks like this:

Eclipse Luna Help in Bot Mode

The next little known things about the Eclipse Infocenter on my list are Deep Linking, Search Links, Language Switching and Debugging Information. Stay tuned!

Flattr this

Eclipse Infocenters in the Wild

August 30, 2014

Apart from for Luna and previous simultaneous releases Eclipse offers its Infocenter for Orion:
Eclipse Orion Help

In the wild the Infocenter is used for instance by Tasktop without modification except an additional header…
Tasktop User Guide

… or by Freescale and by bada Developers:
bada Documentation - bada Developers

I like the red style of Wolfram. Even the icons have been adapted:
Wolfram Workbench Documentation

ARM has made functional changes to the Infocenter. With the menu to the left of the search box you can select where to search, e. g. within the title only or in the whole document. Interestingly, some icons have been removed: there is no Print/Search Topic (and its Subtopics) icon and no Link with Contents icon in the Contents toolbar; no Group by Categories and no number of matches in Search Results.
ARM Information Center

Sybase also made some search modifications. The drop-down menu right of the search field makes it easier to switch between search scopes that have been created. The flashlight symbol of the search icon to search a topic (and its subtopics) has been replaced with a magnifying glass.
SyBooks Online

The Infocenter of VMware is hardly recognizable as such. The tabs are shown at the top instead of at the bottom. Maybe because today common web browsers do not have a status line and show the target of a link while hovering it in the left bottom corner which hides bottom tabs.
VMware vCenter Site Recovery Manager 5.1 Documentation Library

IBM, the company which has done most of the development work for Eclipse’s Infocenter, added a Collaboration tab to show hot topics and – if logged in – the user’s own comments. There is also a frame below the topic frame for topic-specific comments.
IBM Content Analytics Information Center

IBM has begun to replace this and other Infocenter instances with its new Knowledge Center. I guess but I don’t know that it is still based on Eclipse Infocenter. It does not use HTML framesets but an iframe for the topic. The search field is wider and the search scope follows automatically the selected book which covers a product.
IBM Knowledge Center

Most of the modifications described above are about searching. Please drop a comment if you have come across an Infocenter with other modifications. If you like a modification then report it to Eclipse, or even better, implement it and contribute it to Eclipse and watch them reintroduce it into the wild.

Flattr this

Like to pimp your help, eh?

August 19, 2014

Assuming you have help content and it comprises more than a couple of sentences, your users will explore it by searching the whole content or by following hyperlink by hyperlink, digging deeper level by level into the table of contents. In Eclipse Help it is also possible to search only part of the content by defining a scope or by selecting a topic and searching its subtopics. But this is rarely used because it is cumbersome. Also the wildcards ‘*’, ‘?’ and the boolean operators NOT and OR are rarely used. Just like with Google or DuckDuckGo people tend to search for keywords only.

Autocomplete, instant search and more

Eclipse Luna Help Demo Page
To make searching easier I developed for Advantest a small JavaScript which Advantest made Open Source. It is used to pimp the Advantest SOC help cover page by a search field with autocomplete, instant search (= search results are shown as you type), book selector drop-down menu and input assistance for complex queries.

Try it!

The Advantest SOC help is for customers only, but you can see the JavaScript eh.js (uncompressed, compressed) in action at the Eclipse Luna Help demo page which I have created. Because in JavaScript cross-domain callbacks (which are required for the instant search) are forbidden, this sample page misuses a proxy which makes it slower than when integrated into your help. To see the content of a topic by hovering a search result you have to allow insecure content: click the shield icon in the address bar:
Click the shield icon in the address bar  to allow insecure content

Get inspired

eh.js can also be used for searching a particular part such as a book or a chapter: Place the mouse over a TOC item link to display a search field for this topic and its subtopics only. Eclipse Luna Help contains 66 books and probably you do not want to get your search results flooded by hits in all of them. Or maybe you will use eh.js as a starting point to develop a complete new user interface for the good old Eclipse Help. What should it look like?

Flattr this

Luna: 1,000,000 Downloads in Less than Two Weeks

July 8, 2014

Today, the counter of the 13 Luna download packages passed the 1,000,000 mark. Two weeks for 1,000,000 downloads, that’s even faster than Kepler with 18 days. 70% of the downloads are from the three packages Classic, Java EE and Java. Three out of 13 (= 23%) packages for these 70% of the downloads are close to the 80–20 rule.

Eclipse Luna 1,000,000 downloads - Packages pie chart

Compared to Kepler (Release plus SR1 plus SR2), which was downloaded 28,951,122 times, C/C++ has increased its percentage from 6.6% to 8.1%. The percentage of Classic has fallen from 43.4% to 36.3%. The new PHP package has already been downloaded more than 50,000 times (5.1%). The percentages of the other packages remained more or less unchanged.

Flattr this

Luna Rising

June 25, 2014

In one year, 687 authors (339 committers and 348 contributors) committed about 40,000 changes to 76 Luna projects. With 61 million lines of code Luna is the largest simultaneous release ever.

Eclipse Simultaneous Releases

Some highlights from my point of view:

  • Java 8 support by Java Development Tools (Java IDE) and by API Tools (part of the Plug-in Development Environment), as well as by other Luna projects like Xtend, Object Teams and – thanks to the unchanged heap dump format – Memory Analyzer.
    Source > Clean Up... > Code Style > Convert functional interface instances
  • Code Recommenders’ Snipmatch: Its usefulness depends on the quantity of good code snippets. So please share your cool snippets to make this an awesome feature!
  • EGit’s rewrite feature of commit messages and the Interactive Rebase View: Maybe, in future Git and I will become friends. 😉
    Interactive Rebase View
  • Split Editor: a 12-year-old bug has been fixed. Hoorray!
  • Dark Theme: Even if I prefer brighter themes it’s good to have a choice.
    Window > Preferences > General > Appearance
  • The new Terminals View (of the Target Communication Framework): command line (local computer) and PuTTY (remote computers) replacement.
    Terminals View

For detailed information read my article “Mein Luna-Jahresrückblick” (in German) in the upcoming (25th July) Eclipse Magazin or in a condensed form online.

PS: Please feel free to use the diagram and screenshots (attribution is nice to have but not required). I opened a bug to collect and share material to promote Luna.

Flattr this

Happy Easter with Egglipse!

April 21, 2014

EgglipseCan you find the Easter egg in Eclipse? Granted, it’s not a real Easter egg, but an egg or rather a non-circular ellipse. The Eclipse ellipse can be found in the program and window icons (not in the splash screen).

For instance, in eclipse256.png the Eclipse marble is 230 pixels wide and 223 (instead of 230) pixels high:


I’m curious how the new Egglipse Eclipse logo will look by Christmas. 😉

Flattr this

Florian Weßling: Eclipse Word-Wrap-Plugin now ready for XML

February 10, 2014

Just in case you missed Florian’s update of his Word-Wrap plug-in to support XML editors on Planet Eclipse:

Eclipse Word-Wrap-Plugin now ready for XML

New Vex Committer and Vex 1.1 M3

October 3, 2013

The first milestone of Vex 1.1 was published some months ago (if you don’t know Vex yet: it stands for Visual Editor for XML and is an Eclipse XML editor with a word processor like interface). Since then Carsten Hiesserich has joined the project team and mainly works on Vex’s built-in support for DocBook.

One month ago, with the second milestone we switched to Kepler. Unfortunately, the Eclipse Marketplace showed a couple of “one or more required items could not be found” errors and the number of milestone installations fell below 100 per month for the first time. So we decided to switch back to Juno (Eclipse 3.x) only for Vex 1.1, which is scheduled to be released in June 2014.

A couple of bugs have been fixed for DocBook support. In addition, in the Outline View there are now buttons to toggle the visibility of inline elements (block element block elements are always shown), of processing instructions, of comments and of the first part of the contained text:

Outline View of Vex 1.1 M3

The Vex project has started to use Gerrit, a code review system which is used by other Eclipse projects, too. Vex also has a new separate Hudson instance which is required by Gerrit to veto a commit on failing JUnit tests. And this is Gerry, not to be confused with Gerrit, a young tomcat loafing around and vetoing my coding by walking over the keyboard from time to tim111111111111klllllllllllllll

Gerry (a young tomcat) chilling out

Don’t be a fraidy-cat and get Vex 1.1 M3 with the new features and maybe new bugs! 😉

Drag to install: (or use Update Site

Flattr this

Kepler: 1 Million Downloads

July 14, 2013

Overall, the 12 Kepler packages have now been downloaded one million times. On average, one million times in less than 18 days means one every 1.5 seconds. Wow!

Kepler Downloads Pie-Chart

In Kepler the Eclipse for Mobile Developers package is missing and the Classic package has been replaced by the Standard package which contains now the Marketplace client and Git. The first three most downloaded packages are all about Java development and have together a market share of more than 80%. The first non-Java package is the Eclipse IDE for C/C++ Developers with 6.5% market share.

Juno Downloads Pie-Chart

The 13 Juno packages were downloaded approximately 28 million times (R, SR1, SR2 summed, Classic estimated). That was even one every 1.1 seconds. But in contrast to Kepler Eclipse 4.2.x was counted as the Classic package. In Kepler Eclipse Standard is not the same as Eclipse 4.3.0 and is not included in this calculation.

Flattr this