docserver.h

Go to the documentation of this file.

/* Copyright (C) 2012 Oliver Lemke <olemke@core-dump.info>

   This program is free software; you can redistribute it and/or modify it
   under the terms of the GNU General Public License as published by the
   Free Software Foundation; either version 2, or (at your option) any
   later version.

   This program is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   GNU General Public License for more details.

   You should have received a copy of the GNU General Public License
   along with this program; if not, write to the Free Software
   Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307,
   USA. */

#ifndef docserver_h
#define docserver_h

#include "arts.h"
#include "exceptions.h"

#ifdef ENABLE_DOCSERVER
class Docserver {
private:
  string         mbaseurl;
  Index          mport;
  ostream*       mos;
  vector<string> tokens;
  
  void begin_page(string title);
  void end_page();
  void begin_content();
  void end_content();
  
  String insert_agenda_link(const String& aname);
  String insert_group_link(const String& gname);
  String insert_wsm_link(const String& mname);
  String insert_wsv_link(const String& vname);

  void insert_title(const string& title = "");
  void insert_breadcrumb_token(size_t token_id);
  void insert_breadcrumbs();
  void insert_error_message(const string& error = "");
  
  void insert_stylesheet();
  void insert_broken_doc_links();
  vector<string> find_broken_description_links(const String& desc, const String& mname = "");
  void insert_index();
  void insert_doc();
  void insert_error(const string& error);
  
  void list_agendas();
  void list_groups();
  void list_methods();
  void list_variables();
  
  String description_add_links(const String& desc, const String& mname = "");
  
  void doc_method(const string& mname);
  void doc_variable_methods(const string& vname);
  void doc_variable(const string& vname);
  void doc_agenda(const string& aname);
  void doc_group(const string& gname);
  
  void find_token_type();

  string html_escape_char(const char ch);
  string html_escape_string(const string& s);

  void split_tokens(const string& s);

  void limit_line_length(ostringstream& curline,
                         ostringstream& token,
                         const String&  indent,
                         size_t         linelen);

  ostream& get_os()
  {
    if (!mos) throw runtime_error("Output stream for docserver is NULL.");
    return *mos;
  }

public:
  Docserver(const Index port, const string& baseurl = "");

  string new_page(const string& url);
  
  void set_ostream(ostream& os) { mos = &os; }
  void clear_ostream() { mos = NULL; }
  
  const string& get_baseurl() { return mbaseurl; }
  int launch(bool daemon);
};

#endif /* ENABLE_DOCSERVER */

#endif /* docserver_h */