summaryrefslogblamecommitdiff
path: root/src/compiler/scala/tools/nsc/doc/html/page/Index.scala
blob: 09da71fc1fce4a81923aaa09a8ea869d97932fcc (plain) (tree)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
                            
                                












                                               
                                                                                            
 
                               
 




                                                                       
 
               
               



                                                                                                                
                                                                                              
                                                                                                  

                
            
          
                        







                                                                                                             
            


               
                   
                                             








                                                                                                                               











                                                                                                         
             





















                                                                                                                                              
               
 


                                                                                                                       
 

                                                                                                          
 




                                                                                                        
 
                                                                                                     
 


                                                                                                                                                 
                 
 











                                                                                    
                   
          
                




                                                                                                       
/* NSC -- new Scala compiler
 * Copyright 2007-2010 LAMP/EPFL
 * @author  David Bernard, Manohar Jonnalagedda
 */

package scala.tools.nsc
package doc
package html
package page

import model._

import scala.collection._
import scala.xml._

class Index(universe: Universe, indexModel: IndexModelFactory#IndexModel) extends HtmlPage {

  def path = List("index.html")

  def title = {
    val s = universe.settings
    ( if (!s.doctitle.isDefault) s.doctitle.value else "" ) +
    ( if (!s.docversion.isDefault) (" " + s.docversion.value) else "" )
  }

  val headers =
    <xml:group>
      <link href={ relativeLinkTo{List("index.css", "lib")} }  media="screen" type="text/css" rel="stylesheet"/>
      <script type="text/javascript" src={ relativeLinkTo{List("jquery.js", "lib")} }></script>
      <script type="text/javascript" src={ relativeLinkTo{List("jquery-ui.js", "lib")} }></script>
      <script type="text/javascript" src={ relativeLinkTo{List("jquery.layout.js", "lib")} }></script>
      <script type="text/javascript" src={ relativeLinkTo{List("index.js", "lib")} }></script>
      <script type="text/javascript" src={ relativeLinkTo{List("scheduler.js", "lib")} }></script>
    </xml:group>

  val body =
    <body>
      <div id="library">
        <img class='class icon' width="13" height="13" src={ relativeLinkTo{List("class.png", "lib")} }/>
        <img class='trait icon' width="13" height="13" src={ relativeLinkTo{List("trait.png", "lib")} }/>
        <img class='object icon' width="13" height="13" src={ relativeLinkTo{List("object.png", "lib")} }/>
        <img class='package icon' width="13" height="13" src={ relativeLinkTo{List("package.png", "lib")} }/>
      </div>
      { browser }
      <div id="content" class="ui-layout-center">
        <iframe name="template" src={ relativeLinkTo{List("package.html")} }/>
      </div>
    </body>

  def browser =
	<xml:group>
    <div id="browser" class="ui-layout-west">
      <div class="ui-west-north">{
        <div class="letters">
	      { for(l <- indexModel.keySet.toList.sortBy( _.toString )) yield { // TODO there should be a better way to do that
	          val ch = if(l=='#') "%23" else l // url encoding if needed
              <a target="template" href={"index/index-"+ch+".html"}>{l.toUpper}</a> ++ xml.Text(" ")
          } }
	    </div>
      }</div>
      <div class="ui-west-center">
      <div id="filter"></div>
      <div class="pack" id="tpl">{
        def isExcluded(dtpl: DocTemplateEntity) = {
          val qname = dtpl.qualifiedName
          ( ( qname.startsWith("scala.Tuple") || qname.startsWith("scala.Product") ||
              qname.startsWith("scala.Function") || qname.startsWith("scala.runtime.AbstractFunction")
            ) && !(
              qname == "scala.Tuple1" || qname == "scala.Tuple2" ||
              qname == "scala.Product" || qname == "scala.Product1" || qname == "scala.Product2" ||
              qname == "scala.Function" || qname == "scala.Function1" || qname == "scala.Function2" ||
              qname == "scala.runtime.AbstractFunction0" || qname == "scala.runtime.AbstractFunction1" ||
              qname == "scala.runtime.AbstractFunction2"
            )
          )
        }
        def packageElem(pack: model.Package): NodeSeq = {
          <xml:group>
            { if (!pack.isRootPackage)
                <h3><a class="tplshow" href={ relativeLinkTo(pack) }>{ pack.qualifiedName }</a></h3>
              else NodeSeq.Empty
            }
            <ol class="templates">{
              val tpls: Map[String, Seq[DocTemplateEntity]] =
                (pack.templates filter (t => !t.isPackage && !isExcluded(t) )) groupBy (_.name)

              val placeholderSeq: NodeSeq = <div class="placeholder"></div>

              def createLink(entity: DocTemplateEntity, includePlaceholder: Boolean, includeText: Boolean) = {
                val entityType = docEntityKindToString(entity)
                val linkContent = (
                  { if (includePlaceholder) placeholderSeq else NodeSeq.Empty }
                  ++
                  { if (includeText) <span class="tplLink">{ Text(packageQualifiedName(entity)) }</span> else NodeSeq.Empty }
                )
                <a class="tplshow" href={ relativeLinkTo(entity) }><span class={ entityType }>({ Text(entityType) })</span>{ linkContent }</a>
              }

              for (tn <- tpls.keySet.toSeq sortBy (_.toLowerCase)) yield {
                val entities = tpls(tn)
                val row = (entities find (e => e.isPackage || e.isObject), entities find (e => e.isTrait || e.isClass))

                val itemContents = row match {
                  case (Some(obj), None) => createLink(obj, includePlaceholder = true, includeText = true)

                  case (maybeObj, Some(template)) =>
                    val firstLink = maybeObj match {
                      case Some(obj) => createLink(obj, includePlaceholder = false, includeText = false)
                      case None => placeholderSeq
                    }

                    firstLink ++ createLink(template, includePlaceholder = false, includeText = true)

                  case _ => // FIXME: this default case should not be necessary. For some reason AnyRef is not a package, object, trait, or class
                    val entry = entities.head
                    placeholderSeq ++ createLink(entry, includePlaceholder = false, includeText = true)
                }

                <li title={ entities.head.qualifiedName }>{
                  itemContents
                }</li>
              }
            }</ol>
            <ol class="packages"> {
              for (sp <- pack.packages sortBy (_.name.toLowerCase)) yield
                <li class="pack" title={ sp.qualifiedName }>{ packageElem(sp) }</li>
            }</ol>
          </xml:group>
        }
        packageElem(universe.rootPackage)
      }</div></div>
    </div>
    </xml:group>

  def packageQualifiedName(ety: DocTemplateEntity): String =
    if (ety.inTemplate.isPackage) ety.name else (packageQualifiedName(ety.inTemplate) + "." + ety.name)

}