worg-editing.org

   1 #+STARTUP:    align fold nodlcheck hidestars oddeven lognotestate
   2 #+SEQ_TODO:   TODO(t) INPROGRESS(i) WAITING(w@) | DONE(d) CANCELED(c@)
   3 #+TAGS:       Write(w) Update(u) Fix(f) Check(c)
   4 #+EMAIL:      mdl AT imapmail DOT org
   5 #+TITLE:      How to edit Worg files?
   6 #+AUTHOR:     Worg people
   7 #+LANGUAGE:   en
   8 #+PRIORITIES: A C B
   9 #+CATEGORY:   worg
  10 #+OPTIONS:    H:3 num:nil toc:t \n:nil @:t ::t |:t ^:t -:t f:t *:t TeX:t LaTeX:t skip:nil d:(HIDE) tags:not-in-toc
  11
  12 [[file:index.org][{Back to Worg's index}]]
  13
  14 Since Worg is just starting now, these conventions are just suggestions,
  15 not recommendations.  Please improve this.
  16
  17 * Conventions
  18   :PROPERTIES:
  19   :CUSTOM_ID: worg-conventions
  20   :END:
  21 ** To-do keywords
  22
  23 Here is a table with default to-do keywords and their meaning.
  24
  25 | To-do keyword | Meaning                                  |
  26 |---------------+------------------------------------------|
  27 | TODO(t)       | Things to do                             |
  28 | INPROGRESS(i) | Thing being in the process of being done |
  29 | WAITING(w@)   | Tasks stuck at some point                |
  30 | DONE(d)       | Done task                                |
  31 | CANCELED(c@)  | Canceled task                            |
  32
  33 Feel free to discuss the relevance of these keywords and propose
  34 changes.
  35
  36 ** Tags
  37
  38 : Write(w) Update(u) Fix(f) Check(c)
  39
  40 ** Encoding
  41 ** Properties
  42 ** Link abbrevations
  43 ** Conventions about content?
  44 ** How rigid are these conventions?
  45
  46 (Suggestion: the farther from the index page you are, the more flexible
  47 the conventions should perhaps be.)
  48
  49 * How do I link to other Worg files?
  50   :PROPERTIES:
  51   :CUSTOM_ID: creating-links
  52   :END:
  53
  54 Links to other Worg pages should have the following format:
  55
  56 : [[file:index.org][Worg's home page]]
  57
  58 This link will converted to a relative html link on export that looks
  59 like this:
  60
  61 [[file:index.org][Worg's home page]]
  62
  63 The filename should be a relative path. Thus, if you are creating a
  64 link to the index from within the org-tutorials directory, you should
  65 enter the path as follows:
  66
  67 : [[file:../index.org][Worg's home page]]
  68
  69 The easiest way to create links to files is by typing =C-c C-l= while
  70 editing an org file. This will prompt you for both components of the
  71 link. (Be sure to enter =file:= before the path; this indicates the
  72 type of link.)
  73
  74 To enter file links more easily, you can simply type =C-u C-c C-l=. This
  75 will allow you to locate the file using emacs' built-in completion
  76 facilities and will automatically add the =file:= prefix.
  77
  78 One note of caution here: the path of the resulting link created
  79 depends on the setting of =org-link-file-path-type=. To ensure that you
  80 always use relative links, you can add the following to your =.emacs=
  81 file:
  82
  83 (setq org-link-file-path-type 'relative)
  84
  85 * What is the default header for new files?
  86
  87 You can find a default header here: [[file:worg-header.org][worg-header.org]]
  88
  89 * How do I create a file?
  90
  91 Just create it.  Before committing changes in Worg, make sure you add
  92 the file to the repository index with =git add *.org=.
  93
  94 * What about dynamic blocks
  95
  96 If you are using dynamic blocks in Worg, please don't forget to add the
  97 relevant code in the [[file:code/elisp/worg.el][code/elisp/worg.el]] file.  See for example the dynamic
  98 block for the timestamp in the [[file:index.org][index]] page.
  99
 100 * What about macros
 101
 102 If you are using macros, please add them to =macros.setupfile=.
 103
 104 ** COMMENT Defined macros explained
 105
 106 *** Environments
 107
 108     - BeginMiniPage ... EndMiniPage :: creates a mini page with a border. Used to
 109          demonstrate layouts (see: [[file:./org-tutorials/images-and-xhtml-export.org]] for
 110          an example).
 111
 112     - BeginInfoBox ... EndInfoBox :: inserts a box with a little info icon on the
 113          left. The text inside flows around the icon. Both, info and warning boxes,
 114          use the styles for =.org-info-box= in [[file:worg.css::org-info-box][worg.css]].
 115
 116     - BeginWarningBox ... EndWarningBox :: Like =BeginInfoBox= and =EndInfoBox=. The
 117          icon used is different.
 118
 119     - BeginBlindText ... EndBlindText :: creates a =<span></span>= element, that
 120          greys out the text. Used for text that is there just to fill paragraphs
 121          to demonstrate text flow (see:
 122          [[file:./org-tutorials/images-and-xhtml-export.org]] for an example).
 123
 124 * How do I link to the Org version of the file?
 125   The raw Org versions of the files are published [[http://orgmode.org/worg/sources/][here]].
 126 * COMMENT How do I rename a file?
 127 * COMMENT Can I create a directory?
 128 * COMMENT What about non-org files in the repository?
 129
 130 .el files ?
 131 .pdf files