docutils/tools/editors/emacs/IDEAS.rst

   1 The following is a list of ideas of functionality which would be nice
   2 to have in `rst.el`. In the examples a ``@`` stands for the cursor.
   3
   4 Convert to id
   5 =============
   6
   7 * Convert the region to an HTML id
   8
   9   * For instance "Eine Überschrift" to "eine-berschrift"
  10
  11   * According the same rules as reST does this
  12
  13 Jump to internal target
  14 =======================
  15
  16 * A command to jump to the internal target the point is on
  17
  18 * A target may be
  19
  20   * A section title
  21
  22   * Footnotes / citations
  23
  24   * Inline internal targets
  25
  26   * Hyperlink target definition
  27
  28   * Substitution definition
  29
  30 * See hunk #26 in `rst_el-emacs_V23_1_patch1_1_2` vs. `emacs_V23_1`
  31   for some ideas
  32
  33 Completion for directive options
  34 ================================
  35
  36 * Imagine ::
  37
  38     .. list-table::
  39        :@
  40
  41   with the cursor at the asterisk
  42
  43 * There should be a command which offers all the possible options for
  44   this particular directive as completion
  45
  46 * May be `skeleton.el` can also be useful
  47
  48 Completion for directives
  49 =========================
  50
  51 * Imagine ::
  52
  53     .. @
  54
  55 * There should be a command which offers all directives as completion
  56
  57 * May be this should work for other keywords as well
  58
  59 * May be this could work even at the beginning of the line
  60
  61 * Completion must be bound to M-TAB
  62
  63   * Already existing binding must be chained
  64
  65   * May be `expand.el` can help (look in package finder)?
  66
  67   * May be `hippie` is good here
  68
  69   * Check `(info)autotype`
  70
  71 Completion for user-defined elements
  72 ====================================
  73
  74 * Imagine ::
  75
  76     |@
  77
  78   or ::
  79
  80     [@
  81
  82   or ::
  83
  84     _@
  85
  86 * There should be a command which offers all defined substitutions /
  87   footnotes / links as completion
  88
  89 Insertion of link alias
  90 =======================
  91
  92 * Imagine ::
  93
  94     Aspect of something
  95     ===================
  96
  97     This is about the `aspect of something`_@
  98
  99 * There should be a command which asks you for an alias for the link,
 100   add the alias and change the link ::
 101
 102     .. _aspects of something:
 103
 104     Aspect of something
 105     ===================
 106
 107     This is about the `aspects of something`_@
 108
 109 Smart use of `iimage-mode`
 110 ==========================
 111
 112 * There is `iimage-mode` which shows ``.. image::``\s in Emacs
 113
 114 * May be we can add a binding to toggle it
 115
 116 TOC in speedbar
 117 ===============
 118
 119 * If the TOC is displayed in the speedbar this could be used for
 120   permanent navigation
 121
 122 toc-mode without markup
 123 =======================
 124
 125 * The markup which may be contained in a section title is not useful
 126   in toc-mode and should be suppressed
 127
 128 Sophisticated navigation in sections
 129 ====================================
 130
 131 * Navigation in sections similar to navigation in other structured data
 132
 133   * Like XML, Lisp
 134
 135   * C-M-u für Up
 136
 137   * C-M-d für Down
 138
 139   * C-M-f / C-M-b für Forward / Backward
 140
 141 Display of current location
 142 ===========================
 143
 144 * Display the "section path" to the current point
 145
 146 * Like in XML: In which element is the point?
 147
 148 toc-mode only to a certain level
 149 ================================
 150
 151 * If a TOC buffer is created a prefix argument should limit the depth
 152   of the listing to the given level
 153
 154 Imenu support
 155 =============
 156
 157 * Imenu could be supported
 158
 159   * See `(elisp)Imenu`
 160
 161 Outline support
 162 ===============
 163
 164 * Support for `outline-mode' / `allout-mode' would be nice
 165
 166   * Should consider section titles
 167
 168 * May be folding is also possible
 169
 170   * For item lists
 171
 172 Sophisticated filling
 173 =====================
 174
 175 * These things must be filled special:
 176
 177   * Definitions
 178
 179   * Filling of ::
 180
 181       * VeryLongWordSuchAsAnURLVeryLongWordSuchAsAnURLVeryLongWordSuchAsAnURLVeryLongWordSuchAsAnURLVeryLongWordSuchAsAnURL
 182
 183     should work as expected by *not* breaking the line
 184
 185 * These things may not be filled at all
 186
 187   * Literal blocks
 188
 189   * Tables
 190
 191   * Section headers
 192
 193   * Link definitions
 194
 195 Sophisticated indentation
 196 =========================
 197
 198 * It should be generally possible to shift one more to the right
 199
 200   * This makes indentation for quotes possible
 201
 202   * But not for literal blocks
 203
 204 * For item lists the best tab should be on the same level as the last
 205   item::
 206
 207     * bla
 208
 209     @
 210
 211   * The second best tab should be where text starts::
 212
 213       * bla
 214
 215         @
 216
 217 * <backtab> should be used to indent in the other direction
 218
 219   * Or may be C-u <tab> but this has a different meaning
 220
 221 * <tab> could obsolete C-c C-r <tab>
 222
 223   * For this the indentation needs to be determined at the start
 224     instead of per line
 225
 226     * <tab> over list works::
 227
 228         Text
 229
 230           * GGGGGG
 231           * SSSSSSSSSSSSSSS
 232           * TTTTTTTT
 233           * ZZZZZZZZ
 234
 235     * <tab> over list doesn't work::
 236
 237         Text
 238
 239         * GGGGGG
 240         * SSSSSSSSSSSSSSS
 241         * TTTTTTTT
 242         * ZZZZZZZZ
 243
 244 List to sections
 245 ================
 246
 247 * A command would be nice which
 248
 249   * transforms the first level of a nested list in a region into a
 250     header
 251
 252   * removes one level of indentation from the rest of the list
 253
 254 Change section level by more than one step
 255 ==========================================
 256
 257 * It would be nice if <C-h> `rst-adjust` could rotate a section
 258   adornment more than one level
 259
 260 * A modification of the semantic of the prefix arguments could do this
 261
 262   * Non-zero numeric prefix arg n rotates n step in the given direction
 263
 264   * Prefix arg 0 toggles overline / underline
 265
 266     * This would be different from current setup
 267
 268 Compiling for syntax check
 269 ==========================
 270
 271 * Compiling with results going to `/dev/null` would be useful
 272
 273   * This would just do a syntax check with no files lying around
 274
 275 * Toolset choice for <C-c C-c C-c> `rst-compile` must be by
 276   customizable if at all necessary
 277
 278   * Customization group must be used
 279
 280 Renumber an exisiting enumeration
 281 =================================
 282
 283 * Renumbering an exisiting enumeration is not possible yet
 284
 285 Command to move across blocks
 286 =============================
 287
 288 * A command moving forward / backward across the content blocks of the
 289   current block would be nice
 290
 291   * For instance: Move across all blocks contained in an item or field
 292
 293   * This would move to the start of the sibling of the current block
 294
 295   * Would allow to jump to the next item on the same level in a list
 296
 297 * <C-M-f> `forward-sexp` could be a nice binding
 298
 299 rst-toc-insert features
 300 =======================
 301
 302 * The `contents::` options could be parsed to figure out how deep to
 303   render the inserted TOC
 304
 305 * On load, detect any existing TOCs and set the properties for links
 306
 307 * TOC insertion should have an option to add empty lines
 308
 309 * TOC insertion should deal with multiple lines
 310
 311 * Automatically detect if we have a `section-numbering::` in the
 312   corresponding section, to render the toc.
 313
 314 Automatic handling of `.txt` files
 315 ----------------------------------
 316
 317 It would be nice to differentiate between text files using
 318 reStructuredText and other general text files. If we had a function to
 319 automatically guess whether a `.txt` file is following the
 320 reStructuredText conventions, we could trigger `rst-mode` without
 321 having to hard-code this in every text file, nor forcing the user to
 322 add a local mode variable at the top of the file. We could perform
 323 this guessing by searching for a valid adornment at the top of the
 324 document or searching for reStructuredText directives further on.
 325
 326 Entry level for rst-straighten-adornments
 327 -----------------------------------------
 328
 329 * `rst-straighten-adornments` should have an entry level to start at a
 330   lower than the top level
 331
 332   * I for one prefer a verbose style for top level titles which is not
 333     appropriate for documents without titles
 334
 335   * Should be done by a prefix argument