class TaskJuggler::SyntaxReference

# File lib/taskjuggler/SyntaxReference.rb, line 36
def initialize(manual = nil, ignoreOld = false)
  @manual = manual
  @parser = ProjectFileParser.new
  @parser.updateParserTables

  # This hash stores all documented keywords using the keyword as
  # index.
  @keywords = {}
  @parser.rules.each_value do |rule|
    rule.patterns.each do |pattern|
      #  Only patterns that are documented are of interest.
      next if pattern.doc.nil?
      # Ignore deprecated and removed keywords if requested
      next if ignoreOld &&
              [ :deprecated, :removed ].include?(pattern.supportLevel)

      # Make sure each keyword is unique.
      if @keywords.include?(pattern.keyword)
        raise "Multiple patterns have the same keyword #{pattern.keyword}"
      end

      argDocs = []
      # Create a new KeywordDocumentation object and fill-in all extracted
      # values.
      kwd = KeywordDocumentation.new(rule, pattern,
              pattern.to_syntax(argDocs, @parser.rules), argDocs,
              optionalAttributes(pattern, {}), @manual)
      @keywords[pattern.keyword] = kwd
    end
  end

  # Make sure all references to other keywords are present.
  @keywords.each_value do |kwd|
    kwd.crossReference(@keywords, @parser.rules)
  end

  # Figure out whether the keyword describes an inheritable attribute or
  # not.
  @keywords.each_value do |kwd|
    kwd.computeInheritance
  end
end

# File lib/taskjuggler/SyntaxReference.rb, line 80
def all
  sorted = @keywords.keys.sort
  # Register the neighbours with each keyword so we can use this info in
  # navigation bars.
  pred = nil
  sorted.each do |kwd|
    keyword = @keywords[kwd]
    pred.successor = keyword if pred
    keyword.predecessor = pred
    pred = keyword
  end
end

# File lib/taskjuggler/SyntaxReference.rb, line 144
def generateHTMLnavbar(directory, keywords)
  html = HTMLDocument.new
  head = html.generateHead('TaskJuggler Syntax Reference Navigator')
  head << XMLElement.new('base', 'target' => 'display')
  html.html << (body = XMLElement.new('body'))

  body << XMLNamedText.new('Table Of Contents', 'a', 'href' => 'toc.html')
  body << XMLElement.new('br', {}, true)

  normalizedKeywords = {}
  keywords.each do |keyword|
    normalizedKeywords[@keywords[keyword].title] = keyword
  end
  letter = nil
  letters = []
  normalizedKeywords.keys.sort!.each do |normalized|
    if normalized[0, 1] != letter
      letter = normalized[0, 1]
      letters << letter
      body << (h = XMLElement.new('h3'))
      h << XMLNamedText.new(letter.upcase, 'a', 'name' => letter)
    end
    keyword = normalizedKeywords[normalized]
    body << XMLNamedText.new("#{normalized}", 'a',
                             'href' => "#{keyword}.html")
    body << XMLElement.new('br', {}, true)
  end

  html.write(directory + 'navbar.html')

  html = HTMLDocument.new
  head = html.generateHead('TaskJuggler Syntax Reference Navigator')
  head << XMLElement.new('base', 'target' => 'navigator')
  html.html << (body = XMLElement.new('body'))

  body << (divf = XMLElement.new('div'))
  divf << (form = XMLElement.new(
    'form', 'action' => 'http://www.google.com/search',
    'method' => "get", 'target' => '_blank', 'style' => 'margin:0'))
  form << XMLElement.new('input', 'type' => 'text',
                         'value' => '',
                         'maxlength' => '255',
                         'size' => '25',
                         'name' => 'q')
  form << XMLElement.new('input', 'type' => 'submit', 'value' => 'Search')
  form << XMLElement.new('input', 'type' => 'hidden',
                         'value' => 'taskjuggler.org/manual',
                         'name' => 'sitesearch')
  body << (h3 = XMLElement.new('h3'))

  letters.each do |l|
    h3 << XMLNamedText.new(l.upcase, 'a',
                           'href' => "navbar.html##{l}")
  end
  html.write(directory + 'alphabet.html')
end

# File lib/taskjuggler/SyntaxReference.rb, line 134
def generateHTMLreference(directory, keyword)
  if checkKeyword(keyword)
    @keywords[keyword].generateHTML(directory)
  else
    ''
  end
end

# File lib/taskjuggler/SyntaxReference.rb, line 111
def internalReferences
  references = {}
  @keywords.each_value do |keyword|
    (refs = keyword.references.uniq).empty? ||
      references[keyword.keyword] = refs
  end
  references
end

# File lib/taskjuggler/SyntaxReference.rb, line 98
def tableOfContents(toc, sectionPrefix)
  keywords = all
  # Set the chapter name to 'Syntax Reference' with a link to the first
  # keyword.
  toc.addEntry(TOCEntry.new(sectionPrefix, 'Syntax Reference', keywords[0]))
  i = 1
  keywords.each do |keyword|
    title = @keywords[keyword].title
    toc.addEntry(TOCEntry.new("#{sectionPrefix}.#{i}", title, keyword))
    i += 1
  end
end

# File lib/taskjuggler/SyntaxReference.rb, line 123
def to_s(keyword)
  if checkKeyword(keyword)
    @keywords[keyword].to_s
  else
    ''
  end
end