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
  82 (setq org-link-file-path-type 'relative)
  83
  84 * What is the default header for new files?
  85
  86 You can find a default header here: [[file:worg-header.org][worg-header.org]]
  87
  88 * How do I create a file?
  89
  90 Just create it.  Before committing changes in Worg, make sure you add
  91 the file to the repository index with =git add *.org=
  92
  93 * What about dynamic blocks
  94
  95 If you are using dynamic blocks in Worg, please don't forget to add the
  96 relevant code in the [[file:code/elisp/worg.el][code/elisp/worg.el]] file.  See for example the dynamic
  97 block for the timestamp in the [[file:index.org][index]] page.
  98
  99 * What about macros
 100
 101 If you are using macros, please add them to =macros.setupfile=.
 102
 103 ** COMMENT Defined macros explained
 104
 105 *** Environments
 106
 107     - BeginMiniPage ... EndMiniPage :: creates a mini page with a border. Used to
 108          demonstrate layouts (see: [[file:./org-tutorials/images-and-xhtml-export.org]] for
 109          an example).
 110
 111     - BeginInfoBox ... EndInfoBox :: inserts a box with a little info icon on the
 112          left. The text inside flows around the icon. Both, info and warning boxes,
 113          use the styles for =.org-info-box= in [[file:worg.css::org-info-box][worg.css]].
 114
 115     - BeginWarningBox ... EndWarningBox :: Like =BeginInfoBox= and =EndInfoBox=. The
 116          icon used is different.
 117
 118     - BeginBlindText ... EndBlindText :: creates a =<span></span>= element, that
 119          greys out the text. Used for text that is there just to fill paragraphs
 120          to demonstrate text flow (see:
 121          [[file:./org-tutorials/images-and-xhtml-export.org]] for an example).
 122
 123 * How do I link to the Org version of the file?
 124   The raw Org versions of the files are published [[http://orgmode.org/worg/sources/][here]].
 125 * COMMENT How do I rename a file?
 126 * COMMENT Can I create a directory?
 127 * COMMENT What about non-org files in the repository?
 128
 129 .el files ?
 130 .pdf files