help_impl.cpp File Reference

#include "help/help_impl.hpp"
#include "actions/attack.hpp"
#include "display.hpp"
#include "display_context.hpp"
#include "formula/string_utils.hpp"
#include "game_config.hpp"
#include "game_config_manager.hpp"
#include "preferences/game.hpp"
#include "gettext.hpp"
#include "help/help_topic_generators.hpp"
#include "hotkey/hotkey_command.hpp"
#include "picture.hpp"
#include "log.hpp"
#include "map/map.hpp"
#include "font/standard_colors.hpp"
#include "font/sdl_ttf_compat.hpp"
#include "units/race.hpp"
#include "resources.hpp"
#include "sdl/surface.hpp"
#include "serialization/string_utils.hpp"
#include "serialization/unicode_cast.hpp"
#include "serialization/utf8_exception.hpp"
#include "terrain/terrain.hpp"
#include "terrain/translation.hpp"
#include "terrain/type_data.hpp"
#include "time_of_day.hpp"
#include "tod_manager.hpp"
#include "tstring.hpp"
#include "units/types.hpp"
#include "serialization/unicode.hpp"
#include "color.hpp"
#include <cassert>
#include <algorithm>
#include <iterator>
#include <map>
#include <set>

Include dependency graph for help_impl.cpp:

Go to the source code of this file.

Namespaces
	help

Macros
#define	WRN_DP   LOG_STREAM(warn, log_display)
#define	WRN_HP   LOG_STREAM(warn, log_help)
#define	DBG_HP   LOG_STREAM(debug, log_help)

Functions
static bool	help::is_cjk_char (const char32_t ch)
bool	help::section_is_referenced (const std::string &section_id, const config &cfg)
	Return true if the section with id section_id is referenced from another section in the config, or the toplevel. More...
bool	help::topic_is_referenced (const std::string &topic_id, const config &cfg)
	Return true if the topic with id topic_id is referenced from another section in the config, or the toplevel. More...
void	help::parse_config_internal (const config *help_cfg, const config *section_cfg, section &sec, int level=0)
	Recursive function used by parse_config. More...
section	help::parse_config (const config *cfg)
	Parse a help config, return the top level section. More...
std::vector< topic >	help::generate_topics (const bool sort_generated, const std::string &generator)
void	help::generate_sections (const config *help_cfg, const std::string &generator, section &sec, int level)
	Dispatch generators to their appropriate functions. More...
std::string	help::generate_topic_text (const std::string &generator, const config *help_cfg, const section &sec, const std::vector< topic > &generated_topics)
static std::string	help::time_of_day_bonus_colored (const int time_of_day_bonus)
std::vector< topic >	help::generate_time_of_day_topics (const bool)
std::vector< topic >	help::generate_weapon_special_topics (const bool sort_generated)
std::vector< topic >	help::generate_ability_topics (const bool sort_generated)
std::vector< topic >	help::generate_era_topics (const bool sort_generated, const std::string &era_id)
std::vector< topic >	help::generate_faction_topics (const config &era, const bool sort_generated)
std::vector< topic >	help::generate_trait_topics (const bool sort_generated)
std::string	help::make_unit_link (const std::string &type_id)
	return a hyperlink with the unit's name and pointing to the unit page return empty string if this unit is hidden. More...
std::vector< std::string >	help::make_unit_links_list (const std::vector< std::string > &type_id_list, bool ordered=false)
	return a list of hyperlinks to unit's pages (ordered or not) More...
void	help::generate_races_sections (const config *help_cfg, section &sec, int level)
void	help::generate_era_sections (const config *help_cfg, section &sec, int level)
void	help::generate_terrain_sections (section &sec, int)
void	help::generate_unit_sections (const config *, section &sec, int, const bool, const std::string &race)
std::vector< topic >	help::generate_unit_topics (const bool sort_generated, const std::string &race)
UNIT_DESCRIPTION_TYPE	help::description_type (const unit_type &type)
	Return the type of description that should be shown for a unit of the given kind. More...
std::string	help::generate_contents_links (const std::string &section_name, config const *help_cfg)
std::string	help::generate_contents_links (const section &sec, const std::vector< topic > &topics)
const topic *	help::find_topic (const section &sec, const std::string &id)
	Search for the topic with the specified identifier in the section and its subsections. More...
const section *	help::find_section (const section &sec, const std::string &id)
	Search for the section with the specified identifier in the section and its subsections. More...
section *	help::find_section (section &sec, const std::string &id)
std::vector< std::string >	help::parse_text (const std::string &text)
	Parse a text string. More...
std::string	help::convert_to_wml (const std::string &element_name, const std::string &contents)
	Convert the contents to wml attributes, surrounded within [element_name]...[/element_name]. More...
color_t	help::string_to_color (const std::string &s)
	Return the color the string represents. More...
std::vector< std::string >	help::split_in_width (const std::string &s, const int font_size, const unsigned width)
	Make a best effort to word wrap s. More...
std::string	help::remove_first_space (const std::string &text)
std::string	help::get_first_word (const std::string &s)
	Return the first word in s, not removing any spaces in the start of it. More...
void	help::generate_contents ()
	Generate the help contents from the configurations given to the manager. More...
std::string	help::hidden_symbol (bool hidden)
bool	help::is_visible_id (const std::string &id)
bool	help::is_valid_id (const std::string &id)
	Return true if the id is valid for user defined topics and sections. More...
unsigned	help::image_width (const std::string &filename)
void	help::push_tab_pair (std::vector< help::item > &v, const std::string &s, const std::optional< std::string > &image, unsigned padding)
std::string	help::generate_table (const table_spec &tab, const unsigned int spacing)
std::string	help::escape (const std::string &s)
	Prepend all chars with meaning inside attributes with a backslash. More...
std::shared_ptr< terrain_type_data >	help::load_terrain_types_data ()
	Load the appropriate terrain types data to use. More...

Variables
static lg::log_domain	log_display ("display")
static lg::log_domain	log_help ("help")
const game_config_view *	help::game_cfg = nullptr
help::section	help::default_toplevel
help::section	help::hidden_sections
int	help::last_num_encountered_units = -1
int	help::last_num_encountered_terrains = -1
boost::tribool	help::last_debug_state = boost::indeterminate
std::vector< std::string >	help::empty_string_vector
const int	help::max_section_level = 15
const int	help::title_size = font::SIZE_LARGE
const int	help::title2_size = font::SIZE_PLUS
const int	help::box_width = 2
const int	help::normal_font_size = font::SIZE_NORMAL
const unsigned	help::max_history = 100
const std::string	help::topic_img = "help/topic.png"
const std::string	help::closed_section_img = "help/closed_section.png"
const std::string	help::open_section_img = "help/open_section.png"
const std::string	help::default_show_topic = "..introduction"
const std::string	help::unknown_unit_topic = ".unknown_unit"
const std::string	help::unit_prefix = "unit_"
const std::string	help::terrain_prefix = "terrain_"
const std::string	help::race_prefix = "race_"
const std::string	help::faction_prefix = "faction_"
const std::string	help::era_prefix = "era_"
const std::string	help::variation_prefix = "variation_"
const std::string	help::ability_prefix = "ability_"

Macro Definition Documentation

DBG_HP

#define DBG_HP   LOG_STREAM(debug, log_help)

Definition at line 60 of file help_impl.cpp.

WRN_DP

#define WRN_DP   LOG_STREAM(warn, log_display)

Definition at line 56 of file help_impl.cpp.

WRN_HP

#define WRN_HP   LOG_STREAM(warn, log_help)

Definition at line 59 of file help_impl.cpp.

Variable Documentation

log_display

lg::log_domain log_display("display") ( "display"  )

static

log_help

lg::log_domain log_help("help") ( "help"  )

static