Add breadcrumb list

[unasuke]

Motivation

When reading several modules has deeply nested namespaces like OpenSSL, the breadcrumb list is very useful.
In Japanese document (called rurema) has breadcrumb like this.

So, I introduce breadcrumb into rdoc.
I tested on ruby/rdoc and ruby/ruby.

ruby/rdoc

3f19b7a572b883291b7e8f66ec1726fd.mp4

ruby/ruby

26e76f9e48ba1567d606c2efa9001ee7.mp4

Changes

Add methods to RDoc::ClassModule to build breadcrumb metadata.

• RDoc::ClassModule#nesting_namespaces
  • returns array of namespaces that splitted full_name by ::
• RDoc::ClassModule#fully_qualified_nesting_namespaces
  • returns an array of fully qualified namespaces
  • To find RDoc::ClassModule instance from RDoc::Store#classes_hash and RDoc::Store#modules_hash

Add private methods to RDoc::Generator::Darkfish to build breadcrumb data for easy-to-use template erb.

• namespaces_to_class_modules
  • generate hash e.g. { "RDoc" => `RDoc::NormalModule` instance, "ClassModule" => `RDoc::NormalModule` instance }
• generate_namespaces_breadcrumb
  • generate array e.g. [{:name=>"RDoc", :path=>"../RDoc.html", :self=>false}, {:name=>"ClassModule", :path=>"../RDoc/ClassModule.html", :self=>true}]

Then, display the breadcrumb in the class template.

My concerns

• Should be displayed breadcrumb on top-level module/class?
• Should be escape class/module name?
• Should be made configurable to enable or disable breadcrumb?

[unasuke]

In Japanese document (called rurema) has breadcrumb like this.

To be precise, what is displayed in "rurema" is not a breadcrumb list but an inherited list of classes/modules. And this change don't provide an inherited list.

[nobu]

I'm a little concerned about whether the plural term "namespaces" is appropriate here.

[unasuke]

@nobu Is it better for rename to namespace?

[nobu]

The word "namespaces" feels ambiguous; it doesn't represent that it contains what namespaces.
What about "nesting namespaces" or something?

[unasuke]

@nobu Renamed at 11d3c95

[st0012]

I love this feature 👍 Are you ok with rebasing the PR?

[unasuke]

@st0012 Sorry for late, rebased!

[st0012]

Because RDoc's default theme got a big styling improvement this year, the breadcrumbs are now pushed out of the main section, to the top of the navbar:

Also, the default theme now supports very basic responsive design on mobile. So I think you'll need to update CSS to make it work in both desktop and mobile environments.