Refdb

Hex Artifact Content
Login

Artifact 51aab786d82bb16d0434437a932712b88b9d75c1:

Wiki page [Refdb] by matt 2014-09-20 19:18:54.
0000: 44 20 32 30 31 34 2d 30 39 2d 32 30 54 31 39 3a  D 2014-09-20T19:
0010: 31 38 3a 35 34 2e 39 33 36 0a 4c 20 52 65 66 64  18:54.936.L Refd
0020: 62 0a 50 20 37 35 65 35 31 37 30 31 37 35 39 36  b.P 75e517017596
0030: 32 35 39 31 61 35 64 65 63 30 64 37 32 35 62 66  2591a5dec0d725bf
0040: 35 64 36 39 39 66 37 34 34 62 37 31 0a 55 20 6d  5d699f744b71.U m
0050: 61 74 74 0a 57 20 31 39 39 31 0a 3c 68 32 3e 52  att.W 1991.<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 2e 0d 0a 0d 0a 3c 68  and merge.....<h
01c0: 34 3e 4d 6f 74 69 76 65 3c 2f 68 34 3e 0d 0a 0d  4>Motive</h4>...
01d0: 0a 53 74 6f 72 69 6e 67 20 63 6f 6e 66 69 67 75  .Storing configu
01e0: 72 61 74 69 6f 6e 20 64 61 74 61 2c 20 74 65 73  ration data, tes
01f0: 74 20 63 6f 6e 74 72 6f 6c 20 64 61 74 61 20 61  t control data a
0200: 6e 64 20 73 6f 20 66 6f 72 74 68 20 63 61 6e 20  nd so forth can 
0210: 62 65 20 76 65 72 79 20 63 6f 6e 76 65 6e 69 65  be very convenie
0220: 6e 74 20 69 6e 20 61 20 73 70 72 65 61 64 73 68  nt in a spreadsh
0230: 65 65 74 20 62 75 74 20 73 70 72 65 61 64 73 68  eet but spreadsh
0240: 65 65 74 73 20 63 61 6e 6e 6f 74 20 62 65 20 65  eets cannot be e
0250: 61 73 69 6c 79 20 6d 6f 64 69 66 69 65 64 20 69  asily modified i
0260: 6e 20 70 61 72 61 6c 6c 65 6c 20 61 6e 64 20 62  n parallel and b
0270: 72 61 6e 63 68 65 64 20 61 6e 64 20 6d 65 72 67  ranched and merg
0280: 65 64 20 69 6e 20 74 6f 6f 6c 73 20 6c 69 6b 65  ed in tools like
0290: 20 66 6f 73 73 69 6c 20 6f 72 20 67 69 74 2e 20   fossil or git. 
02a0: 0d 0a 0d 0a 3c 68 34 3e 49 6e 66 6f 72 6d 61 74  ....<h4>Informat
02b0: 69 6f 6e 3c 2f 68 34 3e 0d 0a 20 20 2a 20 20 5b  ion</h4>..  *  [
02c0: 52 65 6c 65 61 73 65 20 4e 6f 74 65 73 5d 0d 0a  Release Notes]..
02d0: 20 20 2a 20 20 5b 55 73 61 67 65 5d 0d 0a 20 20    *  [Usage]..  
02e0: 2a 20 20 5b 41 63 63 65 73 73 69 6e 67 20 74 68  *  [Accessing th
02f0: 65 20 64 61 74 61 5d 0d 0a 0d 0a 3c 68 34 3e 49  e data]....<h4>I
0300: 6e 73 74 61 6c 6c 61 74 69 6f 6e 3c 2f 68 34 3e  nstallation</h4>
0310: 0d 0a 0d 0a 20 20 23 20 20 49 6e 73 74 61 6c 6c  ....  #  Install
0320: 20 63 68 69 63 6b 65 6e 20 73 63 68 65 6d 65 20   chicken scheme 
0330: 66 72 6f 6d 3a 20 77 77 77 2e 63 61 6c 6c 2d 63  from: www.call-c
0340: 63 2e 6f 72 67 0d 0a 20 20 23 20 20 49 6e 73 74  c.org..  #  Inst
0350: 61 6c 6c 20 74 68 65 20 72 65 66 64 62 20 65 67  all the refdb eg
0360: 67 3a 20 63 68 69 63 6b 65 6e 2d 69 6e 73 74 61  g: chicken-insta
0370: 6c 6c 20 72 65 66 64 62 0d 0a 0d 0a 3c 68 34 3e  ll refdb....<h4>
0380: 5b 44 61 74 61 20 66 6f 72 6d 61 74 5d 3c 2f 68  [Data format]</h
0390: 34 3e 0d 0a 0d 0a 46 69 6c 65 73 20 77 69 74 68  4>....Files with
03a0: 20 65 78 74 65 6e 73 69 6f 6e 20 2e 64 61 74 20   extension .dat 
03b0: 63 6f 6e 74 61 69 6e 20 74 68 65 20 64 61 74 61  contain the data
03c0: 20 66 6f 72 20 65 61 63 68 20 73 68 65 65 74 2e   for each sheet.
03d0: 20 0d 0a 0d 0a 3c 76 65 72 62 61 74 69 6d 3e 0d   ....<verbatim>.
03e0: 0a 5b 63 6f 6c 75 6d 6e 20 68 65 61 64 65 72 5d  .[column header]
03f0: 0d 0a 72 6f 77 6c 61 62 65 6c 20 76 61 6c 75 65  ..rowlabel value
0400: 0d 0a 3c 2f 76 65 72 62 61 74 69 6d 3e 0d 0a 0d  ..</verbatim>...
0410: 0a 3c 68 34 3e 52 75 6e 20 72 65 66 64 62 20 66  .<h4>Run refdb f
0420: 6f 72 20 71 75 69 63 6b 20 68 65 6c 70 3c 2f 68  or quick help</h
0430: 34 3e 0d 0a 52 75 6e 20 72 65 66 64 62 20 66 72  4>..Run refdb fr
0440: 6f 6d 20 74 68 65 20 63 6f 6d 6d 61 6e 64 6c 69  om the commandli
0450: 6e 65 20 74 6f 20 67 65 74 20 71 75 69 63 6b 20  ne to get quick 
0460: 68 65 6c 70 3a 0d 0a 0d 0a 3c 76 65 72 62 61 74  help:....<verbat
0470: 69 6d 3e 0d 0a 3e 20 72 65 66 64 62 0d 0a 55 73  im>..> refdb..Us
0480: 61 67 65 3a 20 72 65 66 64 62 20 61 63 74 69 6f  age: refdb actio
0490: 6e 20 70 61 72 61 6d 73 20 2e 2e 2e 0d 0a 0d 0a  n params .......
04a0: 4e 6f 74 65 3a 20 72 65 66 64 62 64 69 72 20 69  Note: refdbdir i
04b0: 73 20 61 20 70 61 74 68 20 74 6f 20 74 68 65 20  s a path to the 
04c0: 64 69 72 65 63 74 6f 72 79 20 63 6f 6e 74 61 69  directory contai
04d0: 6e 67 20 73 68 65 65 74 2d 6e 61 6d 65 73 2e 63  ng sheet-names.c
04e0: 66 67 0d 0a 0d 0a 20 20 69 6d 70 6f 72 74 20 66  fg....  import f
04f0: 69 6c 65 6e 61 6d 65 2e 67 6e 75 6d 65 72 69 63  ilename.gnumeric
0500: 20 72 65 66 64 62 64 69 72 20 20 20 3a 20 49 6d   refdbdir   : Im
0510: 70 6f 72 74 20 61 20 67 6e 75 6d 65 72 69 63 20  port a gnumeric 
0520: 66 69 6c 65 20 69 6e 74 6f 20 61 20 74 78 74 20  file into a txt 
0530: 64 62 20 64 69 72 65 63 74 6f 72 79 0d 0a 20 20  db directory..  
0540: 65 78 70 6f 72 74 20 72 65 66 64 62 64 69 72 20  export refdbdir 
0550: 66 69 6c 65 6e 61 6d 65 2e 67 6e 75 6d 65 72 69  filename.gnumeri
0560: 63 20 20 20 3a 20 45 78 70 6f 72 74 20 61 20 72  c   : Export a r
0570: 65 66 64 62 20 74 6f 20 61 20 67 6e 75 6d 65 72  efdb to a gnumer
0580: 69 63 20 66 69 6c 65 0d 0a 20 20 65 64 69 74 20  ic file..  edit 
0590: 20 20 72 65 66 64 62 64 69 72 20 20 20 20 20 20    refdbdir      
05a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 3a                 :
05b0: 20 45 64 69 74 20 61 20 72 65 66 64 62 64 69 72   Edit a refdbdir
05c0: 20 75 73 69 6e 67 20 67 6e 75 6d 65 72 69 63 2e   using gnumeric.
05d0: 0d 0a 20 20 6c 73 20 72 65 66 64 62 64 69 72 20  ..  ls refdbdir 
05e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
05f0: 20 20 20 20 20 20 20 20 3a 20 4c 69 73 74 20 74          : List t
0600: 68 65 20 6b 65 79 73 20 66 6f 72 20 73 70 65 63  he keys for spec
0610: 69 66 69 65 64 20 6c 65 76 65 6c 20 0d 0a 20 20  ified level ..  
0620: 6c 6f 6f 6b 75 70 20 72 65 66 64 62 64 69 72 20  lookup refdbdir 
0630: 73 68 65 65 74 6e 61 6d 65 20 72 6f 77 20 63 6f  sheetname row co
0640: 6c 20 20 20 3a 20 4c 6f 6f 6b 20 75 70 20 61 20  l   : Look up a 
0650: 76 61 6c 75 65 20 69 6e 20 74 68 65 20 74 65 78  value in the tex
0660: 74 20 64 62 20 20 20 0d 0a 20 20 67 65 74 72 6f  t db   ..  getro
0670: 77 6e 61 6d 65 73 20 72 65 66 64 62 20 73 68 65  wnames refdb she
0680: 65 74 6e 61 6d 65 20 20 20 20 20 20 20 20 20 3a  etname         :
0690: 20 47 65 74 20 61 20 6c 69 73 74 20 6f 66 20 72   Get a list of r
06a0: 6f 77 20 74 69 74 6c 65 73 0d 0a 20 20 67 65 74  ow titles..  get
06b0: 63 6f 6c 6e 61 6d 65 73 20 72 65 66 64 62 20 73  colnames refdb s
06c0: 68 65 65 74 6e 61 6d 65 20 20 20 20 20 20 20 20  heetname        
06d0: 20 3a 20 47 65 74 20 61 20 6c 69 73 74 20 6f 66   : Get a list of
06e0: 20 63 6f 6c 75 6d 6e 20 74 69 74 6c 65 73 0d 0a   column titles..
06f0: 0d 0a 54 6f 20 65 78 70 6f 72 74 20 74 6f 20 6f  ..To export to o
0700: 74 68 65 72 20 66 6f 72 6d 61 74 73 3b 20 66 69  ther formats; fi
0710: 72 73 74 20 65 78 70 6f 72 74 20 74 6f 20 67 6e  rst export to gn
0720: 75 6d 65 72 69 63 20 74 68 65 6e 20 75 73 65 20  umeric then use 
0730: 73 73 63 6f 6e 76 65 72 74 2e 0d 0a 0d 0a 65 2e  ssconvert.....e.
0740: 67 2e 20 0d 0a 0d 0a 72 65 66 64 62 20 65 78 70  g. ....refdb exp
0750: 6f 72 74 20 6d 79 64 61 74 61 20 6d 79 64 61 74  ort mydata mydat
0760: 61 2e 67 6e 75 6d 65 72 69 63 0d 0a 73 73 63 6f  a.gnumeric..ssco
0770: 6e 76 65 72 74 20 2d 54 20 47 6e 75 6d 65 72 69  nvert -T Gnumeri
0780: 63 5f 68 74 6d 6c 3a 68 74 6d 6c 34 30 20 6d 79  c_html:html40 my
0790: 64 61 74 61 2e 67 6e 75 6d 65 72 69 63 20 6d 79  data.gnumeric my
07a0: 64 61 74 61 2e 68 74 6d 6c 20 0d 0a 20 20 0d 0a  data.html ..  ..
07b0: 50 61 72 74 20 6f 66 20 74 68 65 20 4d 65 67 61  Part of the Mega
07c0: 74 65 73 74 20 74 6f 6f 6c 20 73 75 69 74 65 2e  test tool suite.
07d0: 20 4c 65 61 72 6e 20 6d 6f 72 65 20 61 74 20 68   Learn more at h
07e0: 74 74 70 3a 2f 2f 77 77 77 2e 6b 69 61 74 6f 61  ttp://www.kiatoa
07f0: 2e 63 6f 6d 2f 66 6f 73 73 69 6c 73 2f 6d 65 67  .com/fossils/meg
0800: 61 74 65 73 74 0d 0a 0d 0a 56 65 72 73 69 6f 6e  atest....Version
0810: 3a 20 31 2e 30 0d 0a 3c 2f 76 65 72 62 61 74 69  : 1.0..</verbati
0820: 6d 3e 0a 5a 20 34 63 32 34 38 35 39 65 66 36 39  m>.Z 4c24859ef69
0830: 61 37 64 38 30 62 61 61 66 34 31 32 64 63 31 33  a7d80baaf412dc13
0840: 36 64 36 38 35 0a                                6d685.