src/insets/InsetInfo.h

   1 // -*- C++ -*-
   2 /**
   3  * \file InsetInfo.h
   4  * This file is part of LyX, the document processor.
   5  * Licence details can be found in the file COPYING.
   6  *
   7  * \author Bo Peng
   8  *
   9  * Full author contact details are available in file CREDITS.
  10  */
  11
  12 #ifndef INSET_INFO_H
  13 #define INSET_INFO_H
  14
  15 #include "InsetCollapsible.h"
  16
  17 namespace lyx {
  18
  19 class Cursor;
  20
  21 /* InsetInfo displays shortcuts, lyxrc, package and textclass
  22 availability and menu information in a non-editable boxed InsetText.
  23
  24 Output of such an inset may vary from system to system, depending
  25 on LyX and LaTeX configurations. Two LyX help files, LaTeXConfig.lyx
  26 and Shortcuts.lyx make heavy use of this inset. The former uses it
  27 to display the availability of packages and textclasses, the latter
  28 uses it to display currently used shortcuts.
  29
  30 This inset has two arguments: the type and argument of the information. The
  31 screen and latex output is the content of the information. An InsetInfo can
  32 have type "shortcuts", "shortcut", "lyxrc", "package", "textclass", "menu",
  33 "buffer" or "vcs". Arguments and outputs vary by type.
  34
  35 shortcuts: argument of this type of InsetInfo is the name of the LFUN such as
  36     "math-insert \alpha". The syntax is the same as what is used in the bind
  37     and ui files. The output of this inset is all shortcuts for this LFUN
  38     separated by comma.
  39
  40 shortcut: the same as shortcuts, but only output the last shortcut.
  41
  42 lyxrc: argument is the name of the rc entry such as "bind_file". Look in
  43     src/LyXRC.h for available entries. The output is the content of this RC
  44     entry.
  45
  46 package: argument is the name of a latex package such as "listings". The
  47     output is "yes" or "no", indicating the availability of this package.
  48
  49 textclass: argument is the name a textclass such as "article". The output is
  50     "yes" or "no", indicating the availability of this textclass.
  51
  52 menu: argument is the name of the LFUN such as "paste". The syntax is the same
  53     as what is used in the bind and ui files. The output is the menu item that
  54     triggers this LFUN. For example, "File > Paste", where '>' is actually
  55     \lyxarrow (an InsetSpecialChar).
  56
  57 icon: argument is the name of the LFUN such as "paste". The syntax is the same
  58     as what is used in the bind and ui files. The output is the icon use in
  59     the toolbar for this LFUN. Alternatively, argument can be the icon path
  60     without extension specified with respect to the images directory.
  61
  62 buffer: argument can be one of "name", "path", "class". This inset output the
  63     filename, path, and textclass of this buffer.
  64
  65 lyxinfo: argument must (presently) be "version". This inset outputs information
  66     about the version of LyX currently in use.
  67
  68 vcs: argument can be one of "revision", "tree-revision", "author", "time", "date".
  69     This insets outputs revision control information, if available.
  70
  71 There is currently no GUI, no menu entry for this inset. A user can define a
  72 shortcut for "info-insert" (e.g. C-S-I), and
  73
  74 1. input the type and argument of this inset, e.g. "menu paste", in
  75    the work area.
  76 2. select the text and run "info-insert" (e.g. press C-S-I).
  77
  78 An alternative method is to enter command "info-insert type arg" in
  79 the command buffer (view->Toolbar->Command Buffer).
  80
  81 */
  82
  83 class InsetInfo : public InsetCollapsible {
  84 public:
  85         enum info_type {
  86                 BUFFER_INFO,    // Buffer related information
  87                 VCS_INFO,        // Version control information
  88                 PACKAGE_INFO,   // Availability of package
  89                 TEXTCLASS_INFO, // Availability of textclass
  90                 SHORTCUTS_INFO, // Keyboard shortcuts
  91                 SHORTCUT_INFO,  // Keyboard shortcut
  92                 LYXRC_INFO,     // RC entry
  93                 MENU_INFO,      // Which menu item is used for certain function
  94                 ICON_INFO,      // which toolbar icon is used for certain function
  95                 LYX_INFO,        // LyX version information
  96                 UNKNOWN_INFO,   // Invalid type
  97         };
  98
  99         ///
 100         InsetInfo(Buffer * buf, std::string const & info = std::string());
 101         ///
 102         InsetCode lyxCode() const { return INFO_CODE; }
 103         ///
 104         docstring layoutName() const;
 105         ///
 106         Inset * editXY(Cursor & cur, int x, int y);
 107         /** FIXME: we would like to do that, but then InsetText::updateBuffer breaks
 108          * on info insets. Do we need to run this method on InsetInfo contents?
 109          * Having a InsetInfo that hides an InsetText is really annoying, actually.
 110          */
 111         ///bool isActive() const { return false; }
 112         ///
 113         bool editable() const { return false; }
 114         ///
 115         bool hasSettings() const { return true; }
 116         ///
 117         void read(Lexer & lex);
 118         ///
 119         void write(std::ostream & os) const;
 120         ///
 121         std::string infoType() const;
 122         ///
 123         std::string infoName() const { return name_; }
 124         ///
 125         bool validateModifyArgument(docstring const & argument) const;
 126         ///
 127         std::vector<std::pair<std::string,docstring>> getArguments(std::string const &) const;
 128         ///
 129         bool showInsetDialog(BufferView * bv) const;
 130         ///
 131         bool getStatus(Cursor &, FuncRequest const &, FuncStatus &) const;
 132         ///
 133         void doDispatch(Cursor & cur, FuncRequest & cmd);
 134         /// Force inset into LTR environment if surroundings are RTL
 135         bool forceLTR() const;
 136         ///
 137         void setInfo(std::string const & info);
 138         ///
 139         void updateBuffer(ParIterator const & it, UpdateType utype);
 140         ///
 141         docstring toolTip(BufferView const & bv, int x, int y) const;
 142         ///
 143         std::string contextMenu(BufferView const &, int, int) const;
 144         ///
 145         std::string contextMenuName() const;
 146         /// should paragraph indendation be omitted in any case?
 147         bool neverIndent() const { return true; }
 148
 149 private:
 150         ///
 151         virtual Inset * clone() const { return new InsetInfo(*this); }
 152         ///
 153         void error(docstring const & err, Language const *);
 154         ///
 155         void info(docstring const & err, Language const *);
 156         ///
 157         void setText(docstring const & str, Language const *);
 158         // make sure that the other version of setText is still available.
 159         using InsetCollapsible::setText;
 160         ///
 161         bool initialized_;
 162         ///
 163         info_type type_;
 164         ///
 165         std::string name_;
 166         ///
 167         bool force_ltr_;
 168 };
 169
 170
 171 } // namespace lyx
 172
 173 #endif