Refdb

Hex Artifact Content
Login

Artifact 5908d7d42bdcd7df8c5e6479fc89f876ba3b198e:

Wiki page [Refdb] by matt 2014-09-20 19:19:34.
0000: 44 20 32 30 31 34 2d 30 39 2d 32 30 54 31 39 3a  D 2014-09-20T19:
0010: 31 39 3a 33 34 2e 37 36 34 0a 4c 20 52 65 66 64  19:34.764.L Refd
0020: 62 0a 50 20 35 31 61 61 62 37 38 36 64 38 32 62  b.P 51aab786d82b
0030: 62 31 36 64 30 34 33 34 34 33 37 61 39 33 32 37  b16d0434437a9327
0040: 31 32 62 38 38 62 39 64 37 35 63 31 0a 55 20 6d  12b88b9d75c1.U m
0050: 61 74 74 0a 57 20 32 30 33 37 0a 3c 68 32 3e 52  att.W 2037.<h2>R
0060: 65 66 44 42 3c 2f 68 32 3e 0d 0a 0d 0a 28 6e 6f  efDB</h2>....(no
0070: 74 65 3a 20 74 68 69 73 20 77 65 62 73 69 74 65  te: this website
0080: 20 69 73 20 61 20 66 6f 73 73 69 6c 20 73 63 6d   is a fossil scm
0090: 20 72 65 70 6f 73 69 74 6f 72 79 2c 20 6c 65 61   repository, lea
00a0: 72 6e 20 6d 6f 72 65 20 61 74 20 5b 68 74 74 70  rn more at [http
00b0: 3a 2f 2f 66 6f 73 73 69 6c 2d 73 63 6d 2e 6f 72  ://fossil-scm.or
00c0: 67 7c 66 6f 73 73 69 6c 2d 73 63 6d 2e 6f 72 67  g|fossil-scm.org
00d0: 5d 29 0d 0a 0d 0a 2e 2e 2e 20 69 73 20 61 20 74  ])....... is a t
00e0: 6f 6f 6c 20 66 6f 72 20 73 74 6f 72 69 6e 67 20  ool for storing 
00f0: 61 20 74 68 72 65 65 20 6c 65 76 65 6c 20 64 65  a three level de
0100: 65 70 20 68 69 65 72 61 72 63 68 69 63 61 6c 20  ep hierarchical 
0110: 6b 65 79 20 73 74 6f 72 65 20 69 6e 20 66 6c 61  key store in fla
0120: 74 20 74 65 78 74 20 66 69 6c 65 73 20 77 68 69  t text files whi
0130: 6c 65 20 62 65 69 6e 67 20 61 62 6c 65 20 74 6f  le being able to
0140: 20 65 64 69 74 20 74 68 65 20 64 61 74 61 20 77   edit the data w
0150: 69 74 68 20 61 20 73 70 72 65 61 64 73 68 65 65  ith a spreadshee
0160: 74 2e 20 54 68 65 20 66 6c 61 74 20 66 69 6c 65  t. The flat file
0170: 73 20 67 65 6e 65 72 61 74 65 64 20 62 79 20 72  s generated by r
0180: 65 66 64 62 20 61 72 65 20 71 75 69 74 65 20 72  efdb are quite r
0190: 65 73 69 73 74 61 6e 74 20 74 6f 20 63 6f 6e 66  esistant to conf
01a0: 6c 69 63 74 73 20 6f 6e 20 62 72 61 6e 63 68 20  licts on branch 
01b0: 61 6e 64 20 6d 65 72 67 65 20 69 6e 20 73 6f 75  and merge in sou
01c0: 72 63 65 20 63 6f 6e 74 72 6f 6c 20 74 6f 6f 6c  rce control tool
01d0: 73 20 73 75 63 68 20 61 73 20 46 6f 73 73 69 6c  s such as Fossil
01e0: 20 6f 72 20 47 69 74 2e 0d 0a 0d 0a 3c 68 34 3e   or Git.....<h4>
01f0: 4d 6f 74 69 76 65 3c 2f 68 34 3e 0d 0a 0d 0a 53  Motive</h4>....S
0200: 74 6f 72 69 6e 67 20 63 6f 6e 66 69 67 75 72 61  toring configura
0210: 74 69 6f 6e 20 64 61 74 61 2c 20 74 65 73 74 20  tion data, test 
0220: 63 6f 6e 74 72 6f 6c 20 64 61 74 61 20 61 6e 64  control data and
0230: 20 73 6f 20 66 6f 72 74 68 20 63 61 6e 20 62 65   so forth can be
0240: 20 76 65 72 79 20 63 6f 6e 76 65 6e 69 65 6e 74   very convenient
0250: 20 69 6e 20 61 20 73 70 72 65 61 64 73 68 65 65   in a spreadshee
0260: 74 20 62 75 74 20 73 70 72 65 61 64 73 68 65 65  t but spreadshee
0270: 74 73 20 63 61 6e 6e 6f 74 20 62 65 20 65 61 73  ts cannot be eas
0280: 69 6c 79 20 6d 6f 64 69 66 69 65 64 20 69 6e 20  ily modified in 
0290: 70 61 72 61 6c 6c 65 6c 20 61 6e 64 20 62 72 61  parallel and bra
02a0: 6e 63 68 65 64 20 61 6e 64 20 6d 65 72 67 65 64  nched and merged
02b0: 20 69 6e 20 74 6f 6f 6c 73 20 6c 69 6b 65 20 66   in tools like f
02c0: 6f 73 73 69 6c 20 6f 72 20 67 69 74 2e 20 0d 0a  ossil or git. ..
02d0: 0d 0a 3c 68 34 3e 49 6e 66 6f 72 6d 61 74 69 6f  ..<h4>Informatio
02e0: 6e 3c 2f 68 34 3e 0d 0a 20 20 2a 20 20 5b 52 65  n</h4>..  *  [Re
02f0: 6c 65 61 73 65 20 4e 6f 74 65 73 5d 0d 0a 20 20  lease Notes]..  
0300: 2a 20 20 5b 55 73 61 67 65 5d 0d 0a 20 20 2a 20  *  [Usage]..  * 
0310: 20 5b 41 63 63 65 73 73 69 6e 67 20 74 68 65 20   [Accessing the 
0320: 64 61 74 61 5d 0d 0a 0d 0a 3c 68 34 3e 49 6e 73  data]....<h4>Ins
0330: 74 61 6c 6c 61 74 69 6f 6e 3c 2f 68 34 3e 0d 0a  tallation</h4>..
0340: 0d 0a 20 20 23 20 20 49 6e 73 74 61 6c 6c 20 63  ..  #  Install c
0350: 68 69 63 6b 65 6e 20 73 63 68 65 6d 65 20 66 72  hicken scheme fr
0360: 6f 6d 3a 20 77 77 77 2e 63 61 6c 6c 2d 63 63 2e  om: www.call-cc.
0370: 6f 72 67 0d 0a 20 20 23 20 20 49 6e 73 74 61 6c  org..  #  Instal
0380: 6c 20 74 68 65 20 72 65 66 64 62 20 65 67 67 3a  l the refdb egg:
0390: 20 63 68 69 63 6b 65 6e 2d 69 6e 73 74 61 6c 6c   chicken-install
03a0: 20 72 65 66 64 62 0d 0a 0d 0a 3c 68 34 3e 5b 44   refdb....<h4>[D
03b0: 61 74 61 20 66 6f 72 6d 61 74 5d 3c 2f 68 34 3e  ata format]</h4>
03c0: 0d 0a 0d 0a 46 69 6c 65 73 20 77 69 74 68 20 65  ....Files with e
03d0: 78 74 65 6e 73 69 6f 6e 20 2e 64 61 74 20 63 6f  xtension .dat co
03e0: 6e 74 61 69 6e 20 74 68 65 20 64 61 74 61 20 66  ntain the data f
03f0: 6f 72 20 65 61 63 68 20 73 68 65 65 74 2e 20 0d  or each sheet. .
0400: 0a 0d 0a 3c 76 65 72 62 61 74 69 6d 3e 0d 0a 5b  ...<verbatim>..[
0410: 63 6f 6c 75 6d 6e 20 68 65 61 64 65 72 5d 0d 0a  column header]..
0420: 72 6f 77 6c 61 62 65 6c 20 76 61 6c 75 65 0d 0a  rowlabel value..
0430: 3c 2f 76 65 72 62 61 74 69 6d 3e 0d 0a 0d 0a 3c  </verbatim>....<
0440: 68 34 3e 52 75 6e 20 72 65 66 64 62 20 66 6f 72  h4>Run refdb for
0450: 20 71 75 69 63 6b 20 68 65 6c 70 3c 2f 68 34 3e   quick help</h4>
0460: 0d 0a 52 75 6e 20 72 65 66 64 62 20 66 72 6f 6d  ..Run refdb from
0470: 20 74 68 65 20 63 6f 6d 6d 61 6e 64 6c 69 6e 65   the commandline
0480: 20 74 6f 20 67 65 74 20 71 75 69 63 6b 20 68 65   to get quick he
0490: 6c 70 3a 0d 0a 0d 0a 3c 76 65 72 62 61 74 69 6d  lp:....<verbatim
04a0: 3e 0d 0a 3e 20 72 65 66 64 62 0d 0a 55 73 61 67  >..> refdb..Usag
04b0: 65 3a 20 72 65 66 64 62 20 61 63 74 69 6f 6e 20  e: refdb action 
04c0: 70 61 72 61 6d 73 20 2e 2e 2e 0d 0a 0d 0a 4e 6f  params .......No
04d0: 74 65 3a 20 72 65 66 64 62 64 69 72 20 69 73 20  te: refdbdir is 
04e0: 61 20 70 61 74 68 20 74 6f 20 74 68 65 20 64 69  a path to the di
04f0: 72 65 63 74 6f 72 79 20 63 6f 6e 74 61 69 6e 67  rectory containg
0500: 20 73 68 65 65 74 2d 6e 61 6d 65 73 2e 63 66 67   sheet-names.cfg
0510: 0d 0a 0d 0a 20 20 69 6d 70 6f 72 74 20 66 69 6c  ....  import fil
0520: 65 6e 61 6d 65 2e 67 6e 75 6d 65 72 69 63 20 72  ename.gnumeric r
0530: 65 66 64 62 64 69 72 20 20 20 3a 20 49 6d 70 6f  efdbdir   : Impo
0540: 72 74 20 61 20 67 6e 75 6d 65 72 69 63 20 66 69  rt a gnumeric fi
0550: 6c 65 20 69 6e 74 6f 20 61 20 74 78 74 20 64 62  le into a txt db
0560: 20 64 69 72 65 63 74 6f 72 79 0d 0a 20 20 65 78   directory..  ex
0570: 70 6f 72 74 20 72 65 66 64 62 64 69 72 20 66 69  port refdbdir fi
0580: 6c 65 6e 61 6d 65 2e 67 6e 75 6d 65 72 69 63 20  lename.gnumeric 
0590: 20 20 3a 20 45 78 70 6f 72 74 20 61 20 72 65 66    : Export a ref
05a0: 64 62 20 74 6f 20 61 20 67 6e 75 6d 65 72 69 63  db to a gnumeric
05b0: 20 66 69 6c 65 0d 0a 20 20 65 64 69 74 20 20 20   file..  edit   
05c0: 72 65 66 64 62 64 69 72 20 20 20 20 20 20 20 20  refdbdir        
05d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 3a 20 45               : E
05e0: 64 69 74 20 61 20 72 65 66 64 62 64 69 72 20 75  dit a refdbdir u
05f0: 73 69 6e 67 20 67 6e 75 6d 65 72 69 63 2e 0d 0a  sing gnumeric...
0600: 20 20 6c 73 20 72 65 66 64 62 64 69 72 20 20 20    ls refdbdir   
0610: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0620: 20 20 20 20 20 20 3a 20 4c 69 73 74 20 74 68 65        : List the
0630: 20 6b 65 79 73 20 66 6f 72 20 73 70 65 63 69 66   keys for specif
0640: 69 65 64 20 6c 65 76 65 6c 20 0d 0a 20 20 6c 6f  ied level ..  lo
0650: 6f 6b 75 70 20 72 65 66 64 62 64 69 72 20 73 68  okup refdbdir sh
0660: 65 65 74 6e 61 6d 65 20 72 6f 77 20 63 6f 6c 20  eetname row col 
0670: 20 20 3a 20 4c 6f 6f 6b 20 75 70 20 61 20 76 61    : Look up a va
0680: 6c 75 65 20 69 6e 20 74 68 65 20 74 65 78 74 20  lue in the text 
0690: 64 62 20 20 20 0d 0a 20 20 67 65 74 72 6f 77 6e  db   ..  getrown
06a0: 61 6d 65 73 20 72 65 66 64 62 20 73 68 65 65 74  ames refdb sheet
06b0: 6e 61 6d 65 20 20 20 20 20 20 20 20 20 3a 20 47  name         : G
06c0: 65 74 20 61 20 6c 69 73 74 20 6f 66 20 72 6f 77  et a list of row
06d0: 20 74 69 74 6c 65 73 0d 0a 20 20 67 65 74 63 6f   titles..  getco
06e0: 6c 6e 61 6d 65 73 20 72 65 66 64 62 20 73 68 65  lnames refdb she
06f0: 65 74 6e 61 6d 65 20 20 20 20 20 20 20 20 20 3a  etname         :
0700: 20 47 65 74 20 61 20 6c 69 73 74 20 6f 66 20 63   Get a list of c
0710: 6f 6c 75 6d 6e 20 74 69 74 6c 65 73 0d 0a 0d 0a  olumn titles....
0720: 54 6f 20 65 78 70 6f 72 74 20 74 6f 20 6f 74 68  To export to oth
0730: 65 72 20 66 6f 72 6d 61 74 73 3b 20 66 69 72 73  er formats; firs
0740: 74 20 65 78 70 6f 72 74 20 74 6f 20 67 6e 75 6d  t export to gnum
0750: 65 72 69 63 20 74 68 65 6e 20 75 73 65 20 73 73  eric then use ss
0760: 63 6f 6e 76 65 72 74 2e 0d 0a 0d 0a 65 2e 67 2e  convert.....e.g.
0770: 20 0d 0a 0d 0a 72 65 66 64 62 20 65 78 70 6f 72   ....refdb expor
0780: 74 20 6d 79 64 61 74 61 20 6d 79 64 61 74 61 2e  t mydata mydata.
0790: 67 6e 75 6d 65 72 69 63 0d 0a 73 73 63 6f 6e 76  gnumeric..ssconv
07a0: 65 72 74 20 2d 54 20 47 6e 75 6d 65 72 69 63 5f  ert -T Gnumeric_
07b0: 68 74 6d 6c 3a 68 74 6d 6c 34 30 20 6d 79 64 61  html:html40 myda
07c0: 74 61 2e 67 6e 75 6d 65 72 69 63 20 6d 79 64 61  ta.gnumeric myda
07d0: 74 61 2e 68 74 6d 6c 20 0d 0a 20 20 0d 0a 50 61  ta.html ..  ..Pa
07e0: 72 74 20 6f 66 20 74 68 65 20 4d 65 67 61 74 65  rt of the Megate
07f0: 73 74 20 74 6f 6f 6c 20 73 75 69 74 65 2e 20 4c  st tool suite. L
0800: 65 61 72 6e 20 6d 6f 72 65 20 61 74 20 68 74 74  earn more at htt
0810: 70 3a 2f 2f 77 77 77 2e 6b 69 61 74 6f 61 2e 63  p://www.kiatoa.c
0820: 6f 6d 2f 66 6f 73 73 69 6c 73 2f 6d 65 67 61 74  om/fossils/megat
0830: 65 73 74 0d 0a 0d 0a 56 65 72 73 69 6f 6e 3a 20  est....Version: 
0840: 31 2e 30 0d 0a 3c 2f 76 65 72 62 61 74 69 6d 3e  1.0..</verbatim>
0850: 0a 5a 20 35 32 65 31 63 39 34 66 37 39 32 31 31  .Z 52e1c94f79211
0860: 64 35 39 31 62 35 62 34 33 39 62 31 63 61 66 38  d591b5b439b1caf8
0870: 33 37 64 0a                                      37d.