/usr/share/doc/bibus/html/en/bibMSW.htm

<html xmlns:v="urn:schemas-microsoft-com:vml"
xmlns:o="urn:schemas-microsoft-com:office:office"
xmlns:w="urn:schemas-microsoft-com:office:word"
xmlns="http://www.w3.org/TR/REC-html40">

<head>
<meta http-equiv=Content-Type content="text/html; charset=windows-1252">
<meta name=ProgId content=Word.Document>
<meta name=Generator content="Microsoft Word 10">
<meta name=Originator content="Microsoft Word 10">
<link rel=File-List href="bibMSW_files/filelist.xml">
<link rel=Edit-Time-Data href="bibMSW_files/editdata.mso">
<!--[if !mso]>
<style>
v\:* {behavior:url(#default#VML);}
o\:* {behavior:url(#default#VML);}
w\:* {behavior:url(#default#VML);}
.shape {behavior:url(#default#VML);}
</style>
<![endif]-->
<title>bibMSW: MS Word interface to Bibus</title>
<!--[if gte mso 9]><xml>
 <o:DocumentProperties>
  <o:Author>Mounir Errami</o:Author>
  <o:LastAuthor>Mounir Errami</o:LastAuthor>
  <o:Revision>37</o:Revision>
  <o:TotalTime>77</o:TotalTime>
  <o:Created>2006-01-09T01:01:00Z</o:Created>
  <o:LastSaved>2006-01-10T04:21:00Z</o:LastSaved>
  <o:Pages>1</o:Pages>
  <o:Words>1913</o:Words>
  <o:Characters>10909</o:Characters>
  <o:Company> </o:Company>
  <o:Lines>90</o:Lines>
  <o:Paragraphs>25</o:Paragraphs>
  <o:CharactersWithSpaces>12797</o:CharactersWithSpaces>
  <o:Version>10.6735</o:Version>
 </o:DocumentProperties>
</xml><![endif]--><!--[if gte mso 9]><xml>
 <w:WordDocument>
  <w:Zoom>90</w:Zoom>
  <w:GrammarState>Clean</w:GrammarState>
  <w:Compatibility>
   <w:BreakWrappedTables/>
   <w:SnapToGridInCell/>
   <w:WrapTextWithPunct/>
   <w:UseAsianBreakRules/>
  </w:Compatibility>
  <w:BrowserLevel>MicrosoftInternetExplorer4</w:BrowserLevel>
 </w:WordDocument>
</xml><![endif]-->
<style>
<!--
 /* Font Definitions */
 @font-face
	{font-family:SimSun;
	panose-1:2 1 6 0 3 1 1 1 1 1;
	mso-font-alt:\5B8B\4F53;
	mso-font-charset:134;
	mso-generic-font-family:auto;
	mso-font-format:other;
	mso-font-pitch:variable;
	mso-font-signature:1 135135232 16 0 262144 0;}
@font-face
	{font-family:Tahoma;
	panose-1:2 11 6 4 3 5 4 4 2 4;
	mso-font-charset:0;
	mso-generic-font-family:swiss;
	mso-font-pitch:variable;
	mso-font-signature:1627421319 -2147483648 8 0 66047 0;}
@font-face
	{font-family:"\@SimSun";
	mso-font-charset:134;
	mso-generic-font-family:auto;
	mso-font-pitch:variable;
	mso-font-signature:3 135135232 16 0 262145 0;}
 /* Style Definitions */
 p.MsoNormal, li.MsoNormal, div.MsoNormal
	{mso-style-parent:"";
	margin:0in;
	margin-bottom:.0001pt;
	mso-pagination:widow-orphan;
	font-size:12.0pt;
	font-family:"Times New Roman";
	mso-fareast-font-family:"Times New Roman";}
h1
	{mso-style-next:Normal;
	margin-top:12.0pt;
	margin-right:0in;
	margin-bottom:3.0pt;
	margin-left:0in;
	mso-pagination:widow-orphan;
	page-break-after:avoid;
	mso-outline-level:1;
	font-size:16.0pt;
	font-family:Arial;
	mso-fareast-font-family:SimSun;
	mso-font-kerning:16.0pt;
	font-weight:bold;}
h2
	{mso-style-next:Normal;
	margin-top:12.0pt;
	margin-right:0in;
	margin-bottom:3.0pt;
	margin-left:0in;
	mso-pagination:widow-orphan;
	page-break-after:avoid;
	mso-outline-level:2;
	font-size:14.0pt;
	font-family:Arial;
	mso-fareast-font-family:SimSun;
	font-weight:bold;
	font-style:italic;}
p.MsoToc1, li.MsoToc1, div.MsoToc1
	{mso-style-update:auto;
	mso-style-noshow:yes;
	mso-style-next:Normal;
	margin:0in;
	margin-bottom:.0001pt;
	mso-pagination:widow-orphan;
	font-size:12.0pt;
	font-family:"Times New Roman";
	mso-fareast-font-family:"Times New Roman";}
p.MsoToc2, li.MsoToc2, div.MsoToc2
	{mso-style-update:auto;
	mso-style-noshow:yes;
	mso-style-next:Normal;
	margin-top:0in;
	margin-right:0in;
	margin-bottom:0in;
	margin-left:12.0pt;
	margin-bottom:.0001pt;
	mso-pagination:widow-orphan;
	font-size:12.0pt;
	font-family:"Times New Roman";
	mso-fareast-font-family:"Times New Roman";}
a:link, span.MsoHyperlink
	{color:blue;
	text-decoration:underline;
	text-underline:single;}
a:visited, span.MsoHyperlinkFollowed
	{color:purple;
	text-decoration:underline;
	text-underline:single;}
p
	{mso-margin-top-alt:auto;
	margin-right:0in;
	mso-margin-bottom-alt:auto;
	margin-left:0in;
	mso-pagination:widow-orphan;
	font-size:12.0pt;
	font-family:"Times New Roman";
	mso-fareast-font-family:"Times New Roman";}
span.GramE
	{mso-style-name:"";
	mso-gram-e:yes;}
@page Section1
	{size:8.5in 11.0in;
	margin:1.0in 1.25in 1.0in 1.25in;
	mso-header-margin:.5in;
	mso-footer-margin:.5in;
	mso-paper-source:0;}
div.Section1
	{page:Section1;}
 /* List Definitions */
 @list l0
	{mso-list-id:107967805;
	mso-list-type:hybrid;
	mso-list-template-ids:-497112318 67698689 67698691 67698693 67698689 67698691 67698693 67698689 67698691 67698693;}
@list l0:level1
	{mso-level-number-format:bullet;
	mso-level-text:\F0B7;
	mso-level-tab-stop:.5in;
	mso-level-number-position:left;
	text-indent:-.25in;
	font-family:Symbol;}
@list l0:level2
	{mso-level-tab-stop:1.0in;
	mso-level-number-position:left;
	text-indent:-.25in;}
@list l0:level3
	{mso-level-tab-stop:1.5in;
	mso-level-number-position:left;
	text-indent:-.25in;}
@list l0:level4
	{mso-level-tab-stop:2.0in;
	mso-level-number-position:left;
	text-indent:-.25in;}
@list l0:level5
	{mso-level-tab-stop:2.5in;
	mso-level-number-position:left;
	text-indent:-.25in;}
@list l0:level6
	{mso-level-tab-stop:3.0in;
	mso-level-number-position:left;
	text-indent:-.25in;}
@list l0:level7
	{mso-level-tab-stop:3.5in;
	mso-level-number-position:left;
	text-indent:-.25in;}
@list l0:level8
	{mso-level-tab-stop:4.0in;
	mso-level-number-position:left;
	text-indent:-.25in;}
@list l0:level9
	{mso-level-tab-stop:4.5in;
	mso-level-number-position:left;
	text-indent:-.25in;}
@list l1
	{mso-list-id:490562751;
	mso-list-template-ids:940890984;}
@list l1:level1
	{mso-level-number-format:bullet;
	mso-level-text:\F0B7;
	mso-level-tab-stop:.5in;
	mso-level-number-position:left;
	text-indent:-.25in;
	mso-ansi-font-size:10.0pt;
	font-family:Symbol;}
@list l2
	{mso-list-id:684674714;
	mso-list-template-ids:1014032878;}
@list l2:level1
	{mso-level-number-format:bullet;
	mso-level-text:\F0B7;
	mso-level-tab-stop:.5in;
	mso-level-number-position:left;
	text-indent:-.25in;
	mso-ansi-font-size:10.0pt;
	font-family:Symbol;}
@list l3
	{mso-list-id:879629455;
	mso-list-type:hybrid;
	mso-list-template-ids:-237321020 67698689 67698691 67698693 67698689 67698691 67698693 67698689 67698691 67698693;}
@list l3:level1
	{mso-level-number-format:bullet;
	mso-level-text:\F0B7;
	mso-level-tab-stop:.5in;
	mso-level-number-position:left;
	text-indent:-.25in;
	font-family:Symbol;}
@list l3:level2
	{mso-level-tab-stop:1.0in;
	mso-level-number-position:left;
	text-indent:-.25in;}
@list l3:level3
	{mso-level-tab-stop:1.5in;
	mso-level-number-position:left;
	text-indent:-.25in;}
@list l3:level4
	{mso-level-tab-stop:2.0in;
	mso-level-number-position:left;
	text-indent:-.25in;}
@list l3:level5
	{mso-level-tab-stop:2.5in;
	mso-level-number-position:left;
	text-indent:-.25in;}
@list l3:level6
	{mso-level-tab-stop:3.0in;
	mso-level-number-position:left;
	text-indent:-.25in;}
@list l3:level7
	{mso-level-tab-stop:3.5in;
	mso-level-number-position:left;
	text-indent:-.25in;}
@list l3:level8
	{mso-level-tab-stop:4.0in;
	mso-level-number-position:left;
	text-indent:-.25in;}
@list l3:level9
	{mso-level-tab-stop:4.5in;
	mso-level-number-position:left;
	text-indent:-.25in;}
@list l4
	{mso-list-id:886530542;
	mso-list-template-ids:1880141854;}
@list l4:level1
	{mso-level-number-format:bullet;
	mso-level-text:\F0B7;
	mso-level-tab-stop:.5in;
	mso-level-number-position:left;
	text-indent:-.25in;
	mso-ansi-font-size:10.0pt;
	font-family:Symbol;}
@list l5
	{mso-list-id:914709594;
	mso-list-template-ids:1667528622;}
@list l5:level1
	{mso-level-number-format:bullet;
	mso-level-text:\F0B7;
	mso-level-tab-stop:.5in;
	mso-level-number-position:left;
	text-indent:-.25in;
	mso-ansi-font-size:10.0pt;
	font-family:Symbol;}
@list l6
	{mso-list-id:938678652;
	mso-list-template-ids:-1273696130;}
@list l6:level1
	{mso-level-number-format:bullet;
	mso-level-text:\F0B7;
	mso-level-tab-stop:.5in;
	mso-level-number-position:left;
	text-indent:-.25in;
	mso-ansi-font-size:10.0pt;
	font-family:Symbol;}
@list l7
	{mso-list-id:1080061246;
	mso-list-template-ids:2113026076;}
@list l7:level1
	{mso-level-number-format:bullet;
	mso-level-text:\F0B7;
	mso-level-tab-stop:.5in;
	mso-level-number-position:left;
	text-indent:-.25in;
	mso-ansi-font-size:10.0pt;
	font-family:Symbol;}
@list l8
	{mso-list-id:1387684516;
	mso-list-template-ids:-729667668;}
@list l8:level1
	{mso-level-number-format:bullet;
	mso-level-text:\F0B7;
	mso-level-tab-stop:.5in;
	mso-level-number-position:left;
	text-indent:-.25in;
	mso-ansi-font-size:10.0pt;
	font-family:Symbol;}
@list l9
	{mso-list-id:1627391418;
	mso-list-template-ids:-1050524664;}
@list l9:level1
	{mso-level-number-format:bullet;
	mso-level-text:\F0B7;
	mso-level-tab-stop:.5in;
	mso-level-number-position:left;
	text-indent:-.25in;
	mso-ansi-font-size:10.0pt;
	font-family:Symbol;}
@list l10
	{mso-list-id:1733886609;
	mso-list-template-ids:1098533594;}
@list l10:level1
	{mso-level-number-format:bullet;
	mso-level-text:\F0B7;
	mso-level-tab-stop:.5in;
	mso-level-number-position:left;
	text-indent:-.25in;
	mso-ansi-font-size:10.0pt;
	font-family:Symbol;}
@list l11
	{mso-list-id:1854613479;
	mso-list-template-ids:336121124;}
@list l11:level1
	{mso-level-number-format:bullet;
	mso-level-text:\F0B7;
	mso-level-tab-stop:.5in;
	mso-level-number-position:left;
	text-indent:-.25in;
	mso-ansi-font-size:10.0pt;
	font-family:Symbol;}
@list l12
	{mso-list-id:2108502022;
	mso-list-template-ids:877677544;}
@list l12:level1
	{mso-level-number-format:bullet;
	mso-level-text:\F0B7;
	mso-level-tab-stop:.5in;
	mso-level-number-position:left;
	text-indent:-.25in;
	mso-ansi-font-size:10.0pt;
	font-family:Symbol;}
ol
	{margin-bottom:0in;}
ul
	{margin-bottom:0in;}
-->
</style>
<!--[if gte mso 10]>
<style>
 /* Style Definitions */
 table.MsoNormalTable
	{mso-style-name:"Table Normal";
	mso-tstyle-rowband-size:0;
	mso-tstyle-colband-size:0;
	mso-style-noshow:yes;
	mso-style-parent:"";
	mso-padding-alt:0in 5.4pt 0in 5.4pt;
	mso-para-margin:0in;
	mso-para-margin-bottom:.0001pt;
	mso-pagination:widow-orphan;
	font-size:10.0pt;
	font-family:"Times New Roman";}
</style>
<![endif]--><!--[if gte mso 9]><xml>
 <o:shapedefaults v:ext="edit" spidmax="7170"/>
</xml><![endif]--><!--[if gte mso 9]><xml>
 <o:shapelayout v:ext="edit">
  <o:idmap v:ext="edit" data="1"/>
 </o:shapelayout></xml><![endif]-->
</head>

<body lang=EN-US link=blue vlink=purple style='tab-interval:.5in'>

<div class=Section1>

<h1><a name="_Toc124510193"></a><span class=GramE><span style='mso-bookmark:
_Toc124510193'><span style='font-family:Tahoma;mso-bidi-font-family:Arial'>bibMSW</span></span></span><span
style='mso-bookmark:_Toc124510193'><span style='font-family:Tahoma;mso-bidi-font-family:
Arial'>: Bibus interface to MS Word.</span></span><span style='font-family:
Tahoma;mso-bidi-font-family:Arial'> <o:p></o:p></span></h1>

<p class=MsoNormal><span style='font-family:Tahoma;mso-bidi-font-family:"Times New Roman"'>This
module is included into <a href="http://bibus-biblio.sourceforge.net/"
target="_blank">Bibus</a> for versions after 1.1.0. Download it @ <a
href="http://sourceforge.net/projects/bibus-biblio/">http://sourceforge.net/projects/bibus-biblio/</a><o:p></o:p></span></p>

<p class=MsoNormal><o:p>&nbsp;</o:p></p>

<p class=MsoToc1 style='tab-stops:right dotted 431.5pt'><!--[if supportFields]><span
style='mso-element:field-begin'></span><span
style='mso-spacerun:yes'>�</span>TOC \o &quot;1-3&quot; \n \h \z \u <span
style='mso-element:field-separator'></span><![endif]--><span
class=MsoHyperlink><span style='mso-no-proof:yes'><a href="#_Toc124510193"><span
style='font-family:Tahoma;mso-bidi-font-family:"Times New Roman"'>bibMSW: Bibus
interface to MS Word.</span></a></span></span><span style='mso-no-proof:yes'><o:p></o:p></span></p>

<p class=MsoToc2 style='tab-stops:right dotted 431.5pt'><span
class=MsoHyperlink><span style='mso-no-proof:yes'><a href="#_Toc124510194"><span
style='font-family:Tahoma;mso-bidi-font-family:"Times New Roman"'>1. What is
bibMSW?</span></a></span></span><span style='mso-no-proof:yes'><o:p></o:p></span></p>

<p class=MsoToc2 style='tab-stops:right dotted 431.5pt'><span
class=MsoHyperlink><span style='mso-no-proof:yes'><a href="#_Toc124510195"><span
style='font-family:Tahoma;mso-bidi-font-family:"Times New Roman"'>2. How does
bibMSW work when compared to bibOOo (equivalent for OOo Writer)?</span></a></span></span><span
style='mso-no-proof:yes'><o:p></o:p></span></p>

<p class=MsoToc2 style='tab-stops:right dotted 431.5pt'><span
class=MsoHyperlink><span style='mso-no-proof:yes'><a href="#_Toc124510196"><span
style='font-family:Tahoma;mso-bidi-font-family:"Times New Roman"'>3. How long
does it take to format the bibliography in MS Word?</span></a></span></span><span
style='mso-no-proof:yes'><o:p></o:p></span></p>

<p class=MsoToc2 style='tab-stops:right dotted 431.5pt'><span
class=MsoHyperlink><span style='mso-no-proof:yes'><a href="#_Toc124510197"><span
style='font-family:Tahoma;mso-bidi-font-family:"Times New Roman"'>4. How does
bibMSW work?</span></a></span></span><span style='mso-no-proof:yes'><o:p></o:p></span></p>

<p class=MsoToc2 style='tab-stops:right dotted 431.5pt'><span
class=MsoHyperlink><span style='mso-no-proof:yes'><a href="#_Toc124510198"><span
style='font-family:Tahoma;mso-bidi-font-family:"Times New Roman"'>5. How do I define
a Style?</span></a></span></span><span style='mso-no-proof:yes'><o:p></o:p></span></p>

<p class=MsoToc2 style='tab-stops:right dotted 431.5pt'><span
class=MsoHyperlink><span style='mso-no-proof:yes'><a href="#_Toc124510199"><span
style='font-family:Tahoma;mso-bidi-font-family:"Times New Roman"'>6. Who to
cite when using bibMSW/Bibus?</span></a></span></span><span style='mso-no-proof:
yes'><o:p></o:p></span></p>

<p class=MsoToc2 style='tab-stops:right dotted 431.5pt'><span
class=MsoHyperlink><span style='mso-no-proof:yes'><a href="#_Toc124510200"><span
style='font-family:Tahoma;mso-bidi-font-family:"Times New Roman"'>7. Can I
contribute to bibMSW development?</span></a></span></span><span
style='mso-no-proof:yes'><o:p></o:p></span></p>

<p class=MsoToc2 style='tab-stops:right dotted 431.5pt'><span
class=MsoHyperlink><span style='mso-no-proof:yes'><a href="#_Toc124510201"><span
style='font-family:Tahoma;mso-bidi-font-family:"Times New Roman"'>8. FAQs.</span></a></span></span><span
style='mso-no-proof:yes'><o:p></o:p></span></p>

<p class=MsoNormal><!--[if supportFields]><span style='mso-element:field-end'></span><![endif]--><o:p>&nbsp;</o:p></p>

<h2><a name="_Toc124510194"></a><span class=GramE><span style='mso-bookmark:
_Toc124510194'><u><span style='font-family:Tahoma;mso-bidi-font-family:Arial'>1.What</span></u></span></span><span
style='mso-bookmark:_Toc124510194'><u><span style='font-family:Tahoma;
mso-bidi-font-family:Arial'> is bibMSW?</span></u></span><u><span
style='font-family:Tahoma;mso-bidi-font-family:Arial'><o:p></o:p></span></u></h2>

<p style='text-align:justify'><span style='font-family:Tahoma;mso-bidi-font-family:
"Times New Roman"'>This is a module written to complement Bibus. Bibus is
certainly one the best reference management software. Up to now Bibus supported
only <a href="http://www.openoffice.org/">OOo Writer</a>. <span class=GramE>However
a very large majority of �writers� use Microsoft Word (&gt;90%).</span> Thus
bibMSW has been added to Bibus so that Bibus would be usable with Microsoft
Word. <b style='mso-bidi-font-weight:normal'>THIS MODULE IS INSERTED INTO BIBUS
DISTRIBUTION AND YOU DON�T NEED TO INSTALL ANYTHING ELSE THAN BIBUS</b> (and
Microsoft Word obviously). The module uses the <a
href="http://www.python.org/windows/win32com/"><span style='mso-bidi-font-weight:
bold'>win32com</span></a> API, and the <a
href="http://msdn2.microsoft.com/en-us/library/ms254954%28en-us,VS.80%29.aspx"
title=Microsoft.Office.Interop.Word>Microsoft.Office.Interop.Word</a>&nbsp;namespace.
<span class=GramE>bibMSW</span> works with <b style='mso-bidi-font-weight:normal'>Word
Office XP and Word 2003</b>. It might also work with other versions, but this
wasn�t tested. The python version might work with earlier version of Windows.
Bibus executable version won�t work under Windows 9X.<o:p></o:p></span></p>

<h2 style='text-align:justify'><a name="_Toc124510195"><u><span
style='font-family:Tahoma;mso-bidi-font-family:Arial'>2. How does bibMSW work
when compared to bibOOo (equivalent for OOo Writer)?</span></u></a><u><span
style='font-family:Tahoma;mso-bidi-font-family:Arial'><o:p></o:p></span></u></h2>

<p style='text-align:justify'><span style='font-family:Tahoma;mso-bidi-font-family:
"Times New Roman"'>The functionalities are much alike I must say. Very few
things are different. It uses Bibus styles to insert and format citations and
the bibliographic index. However and unlike OOo Writer Word has no
bibliographic function. Therefore the python API calls VB functions to insert
citations and format the bibliography. This translates into a loss of speed
when compared to the OOo equivalent functions. Nevertheless, speed is still
very acceptable and the processing time should decrease in the near future, as
I will learn more about Word tricks.<o:p></o:p></span></p>

<p style='text-align:justify'><span style='font-family:Tahoma;mso-bidi-font-family:
"Times New Roman"'>An important consideration is that all the bibliographic
information is stored in the word document. Therefore, once the reference is
inserted into the document, the database information is no longer needed for
that reference. In other words, no matter where you read/edit your document,
you will be able to format your bibliography as you wish on any computer as
long as you have Bibus installed. You won�t have to keep track of your
reference database or to copy it on the other computer. This is a major
advantage compared to commercial software like EndNote or Reference Manager for
which a version of the database must be present on the computer where you want
to read/format a document containing references inserted with these softwares.
However, this tremendous advantage also explains the longer processing time
(when compared to OOo) given the quantity of the information to process in the
MS Word document.<o:p></o:p></span></p>

<h2 style='text-align:justify'><a name="_Toc124510196"><u><span
style='font-family:Tahoma;mso-bidi-font-family:Arial'>3. How long does it take
to format the bibliography in MS Word?</span></u></a><u><span style='font-family:
Tahoma;mso-bidi-font-family:Arial'><o:p></o:p></span></u></h2>

<p class=MsoNormal style='text-align:justify'><span style='font-family:Tahoma;
mso-bidi-font-family:"Times New Roman"'>This depends pretty much on:<o:p></o:p></span></p>

<p class=MsoNormal style='text-align:justify'><span style='font-family:Tahoma;
mso-bidi-font-family:"Times New Roman"'>1. Your computer<o:p></o:p></span></p>

<p class=MsoNormal style='text-align:justify'><span style='font-family:Tahoma;
mso-bidi-font-family:"Times New Roman"'>2. The number of references in your
document<o:p></o:p></span></p>

<p class=MsoNormal style='text-align:justify'><span style='font-family:Tahoma;
mso-bidi-font-family:"Times New Roman"'>3. The complexity of your format (more
or less fields, more or less formatting operations�)<o:p></o:p></span></p>

<p class=MsoNormal style='text-align:justify'><span class=GramE><span
style='font-family:Tahoma;mso-bidi-font-family:"Times New Roman"'>For an
average bibliography (env. 70 references) on a recent computer (1+ Ghz, 512+
MB) about 40 sec.</span></span><span style='font-family:Tahoma;mso-bidi-font-family:
"Times New Roman"'> For 150 references, it can take up to few minutes (2-3).
But remember that formatting is a step that one has to do at the end. These
processing times are given for the python version. The Windows XP executable
version is slightly slower, but remains with the same range. At that point, the
speed can only improve, so make sure you have the last version of Bibus.<o:p></o:p></span></p>

<h2 style='text-align:justify'><a name="_Toc124510197"><u><span
style='font-family:Tahoma;mso-bidi-font-family:Arial'>4. How does bibMSW work?</span></u></a><u><span
style='font-family:Tahoma;mso-bidi-font-family:Arial'><o:p></o:p></span></u></h2>

<p class=MsoNormal style='text-align:justify'><span class=GramE><span
style='font-family:Tahoma;mso-bidi-font-family:"Times New Roman"'>Simple.</span></span><span
style='font-family:Tahoma;mso-bidi-font-family:"Times New Roman"'> First make
sure that the reference you want to insert is in the <u>�References� key</u> of
your database (The left column has a list of keys: References, Tagged, All,
Queries�): after a search (Medline or eTBlast on Medline), the results are
stored in the �Online� key. You have to drag the reference(s) of your choice to
the �References� key before you can insert it into the document. Once it is
done, select one or more references. Then on the menu: <b style='mso-bidi-font-weight:
normal'>MSWord &gt; Insert Citation(s)</b>. The reference should be inserted
and formatted in your word document. The format depends on the selected style.
To change, add or edit a style, go to the Styles menu. From there, everything
is very intuitive. You should learn fast how to create new styles and use them
with Bibus (more information on style definition <a
href="http://bibus-biblio.sourceforge.net/html/en/usingOOo.html#mozTocId283248"
target="_blank">here</a>).<o:p></o:p></span></p>

<p class=MsoNormal><span style='font-family:Tahoma;mso-bidi-font-family:"Times New Roman"'><!--[if gte vml 1]><v:shapetype
 id="_x0000_t75" coordsize="21600,21600" o:spt="75" o:preferrelative="t"
 path="m@4@5l@4@11@9@11@9@5xe" filled="f" stroked="f">
 <v:stroke joinstyle="miter"/>
 <v:formulas>
  <v:f eqn="if lineDrawn pixelLineWidth 0"/>
  <v:f eqn="sum @0 1 0"/>
  <v:f eqn="sum 0 0 @1"/>
  <v:f eqn="prod @2 1 2"/>
  <v:f eqn="prod @3 21600 pixelWidth"/>
  <v:f eqn="prod @3 21600 pixelHeight"/>
  <v:f eqn="sum @0 0 1"/>
  <v:f eqn="prod @6 1 2"/>
  <v:f eqn="prod @7 21600 pixelWidth"/>
  <v:f eqn="sum @8 21600 0"/>
  <v:f eqn="prod @7 21600 pixelHeight"/>
  <v:f eqn="sum @10 21600 0"/>
 </v:formulas>
 <v:path o:extrusionok="f" gradientshapeok="t" o:connecttype="rect"/>
 <o:lock v:ext="edit" aspectratio="t"/>
</v:shapetype><v:shape id="_x0000_i1025" type="#_x0000_t75" style='width:623.25pt;
 height:470.25pt'>
 <v:imagedata src="bibMSW_files/image001.png" o:title="" croptop="2101f"
  cropbottom="6961f" cropleft="478f" cropright="5301f"/>
</v:shape><![endif]--><![if !vml]><img border=0 width=831 height=627
src="bibMSW_files/image002.jpg" v:shapes="_x0000_i1025"><![endif]><o:p></o:p></span></p>

<p class=MsoNormal><span style='font-family:Tahoma;mso-bidi-font-family:"Times New Roman"'>These
snapshots were <span class=GramE>take</span> with WinXP / Office XP (with
FlyaKite for a Mac Like graphism).<o:p></o:p></span></p>

<p class=MsoNormal><span style='font-family:Tahoma;mso-bidi-font-family:"Times New Roman"'><o:p>&nbsp;</o:p></span></p>

<p class=MsoNormal><span style='font-family:Tahoma;mso-bidi-font-family:"Times New Roman"'>You
have other submenus in MSWord:<o:p></o:p></span></p>

<p class=MsoNormal><b style='mso-bidi-font-weight:normal'><span
style='font-family:Tahoma;mso-bidi-font-family:"Times New Roman"'>Update <span
class=GramE>Citations<span style='font-weight:normal'> :</span></span></span></b><span
style='font-family:Tahoma;mso-bidi-font-family:"Times New Roman"'> To use when
you want to refresh the text of your citation, or to view the changes when you
have changed the style.<o:p></o:p></span></p>

<p class=MsoNormal><span style='font-family:Tahoma;mso-bidi-font-family:"Times New Roman"'><o:p>&nbsp;</o:p></span></p>

<p class=MsoNormal><b style='mso-bidi-font-weight:normal'><span
style='font-family:Tahoma;mso-bidi-font-family:"Times New Roman"'>Update
Bibliographic Index</span></b><span style='font-family:Tahoma;mso-bidi-font-family:
"Times New Roman"'>: Same thing for the bibliographic Index. If the index
doesn�t exist, this function will create it.<o:p></o:p></span></p>

<p class=MsoNormal><span style='font-family:Tahoma;mso-bidi-font-family:"Times New Roman"'><o:p>&nbsp;</o:p></span></p>

<p class=MsoNormal><b style='mso-bidi-font-weight:normal'><span
style='font-family:Tahoma;mso-bidi-font-family:"Times New Roman"'>Update and
Pre-format all</span></b><span style='font-family:Tahoma;mso-bidi-font-family:
"Times New Roman"'>: This will pre-format your bibliography (citation and
index), close to what they will look like after finalization. For instance,
your references will be fused (if the style you use defines these options). <span
class=GramE>To undo, just go to MSWord menu&gt;Update Citation.</span> During
this process, Word document will be minimized, this increases significantly the
speed with which MS Word processes the information. I advise you not to reopen
the windows while Bibus is working on <span class=GramE>it,</span> you could
mess up with your documents (especially if you don�t re-open the correct
window.)<o:p></o:p></span></p>

<p class=MsoNormal><span style='font-family:Tahoma;mso-bidi-font-family:"Times New Roman"'><o:p>&nbsp;</o:p></span></p>

<p class=MsoNormal><b style='mso-bidi-font-weight:normal'><span
style='font-family:Tahoma;mso-bidi-font-family:"Times New Roman"'>Finalize</span></b><span
style='font-family:Tahoma;mso-bidi-font-family:"Times New Roman"'>: This will
finalize your document. To do so, Bibus checks that your document is saved, <span
class=GramE>then</span> opens a copy of your document on which the finalization
will take place (safer). The difference with the Pre-format option is that you
then add the duplicate information when using citations like Smith et al, 2005.
If you have same citations corresponding to different papers, a letter is added
after the year: (Smith et al., 2005a; Smith et al., 2005b). This also figures
in the bibliographic index. During the finalization process, Word document will
be minimized, this increases significantly the speed with which MS Word
processes the information. I advise you not to reopen the windows while Bibus
is <span class=GramE>working,</span> you could mess up with your documents
(especially if you don�t re-open the correct document.)<o:p></o:p></span></p>

<h2 style='text-align:justify'><a name="_Toc124510198"><u><span
style='font-family:Tahoma;mso-bidi-font-family:Arial'>5. How do I define a
Style?</span></u></a><u><span style='font-family:Tahoma;mso-bidi-font-family:
Arial'><o:p></o:p></span></u></h2>

<p class=MsoNormal style='text-align:justify'><span style='font-family:Tahoma;
mso-bidi-font-family:"Times New Roman"'>The process is quite simple, but might
seem disturbing at first. Believe me, learning this is worthwhile. See <a
href="http://bibus-biblio.sourceforge.net/html/en/usingOOo.html#mozTocId283248"
target="_blank">here</a>.<o:p></o:p></span></p>

<h2 style='text-align:justify'><a name="_Toc124510199"><u><span
style='font-family:Tahoma;mso-bidi-font-family:Arial'>6. Who to cite when using
bibMSW/Bibus?</span></u></a><u><span style='font-family:Tahoma;mso-bidi-font-family:
Arial'><o:p></o:p></span></u></h2>

<p class=MsoNormal style='text-align:justify'><span style='font-family:Tahoma;
mso-bidi-font-family:"Times New Roman"'>Publications are under process. Please
come back soon to check out the publications.<o:p></o:p></span></p>

<h2 style='text-align:justify'><a name="_Toc124510200"><u><span
style='font-family:Tahoma;mso-bidi-font-family:Arial'>7. Can I contribute to
bibMSW development?</span></u></a><u><span style='font-family:Tahoma;
mso-bidi-font-family:Arial'><o:p></o:p></span></u></h2>

<p class=MsoNormal style='text-align:justify'><span class=GramE><span
style='font-family:Tahoma;mso-bidi-font-family:"Times New Roman"'>Certainly.</span></span><span
style='font-family:Tahoma;mso-bidi-font-family:"Times New Roman"'> I am writing
documentation as a �quick developer guide� for people wishing to add some <span
class=GramE>functionalities</span>, and improve the performance of bibMSW. And
in case you are willing to help but have no ideas, here are few:<o:p></o:p></span></p>

<ul style='margin-top:0in' type=disc>
 <li class=MsoNormal style='text-align:justify;mso-list:l0 level1 lfo3;
     tab-stops:list .5in'><span style='font-family:Tahoma;mso-bidi-font-family:
     "Times New Roman"'>Add a Word toolbar to format the bibliography (since
     all the information need is in the document, it is feasible)<o:p></o:p></span></li>
 <li class=MsoNormal style='text-align:justify;mso-list:l0 level1 lfo3;
     tab-stops:list .5in'><span style='font-family:Tahoma;mso-bidi-font-family:
     "Times New Roman"'>Launch bibus from word<o:p></o:p></span></li>
 <li class=MsoNormal style='text-align:justify;mso-list:l0 level1 lfo3;
     tab-stops:list .5in'><span style='font-family:Tahoma;mso-bidi-font-family:
     "Times New Roman"'>Click on a reference and opens its medline abstract in
     a buble<o:p></o:p></span></li>
 <li class=MsoNormal style='text-align:justify;mso-list:l0 level1 lfo3;
     tab-stops:list .5in'><span style='font-family:Tahoma;mso-bidi-font-family:
     "Times New Roman"'>Select keywords in the document and search medline with
     a right click<o:p></o:p></span></li>
 <li class=MsoNormal style='text-align:justify;mso-list:l0 level1 lfo3;
     tab-stops:list .5in'><span style='font-family:Tahoma;mso-bidi-font-family:
     "Times New Roman"'>Select a paragraph in the document and eTBlast Medline
     on a right click<o:p></o:p></span></li>
 <li class=MsoNormal style='text-align:justify;mso-list:l0 level1 lfo3;
     tab-stops:list .5in'><span style='font-family:Tahoma;mso-bidi-font-family:
     "Times New Roman"'>A new way to add a Style to Bibus: using a formatted
     references in a document and say to Bibus �this is the format I want�.
     Bibus would create the style file automatically.<o:p></o:p></span></li>
</ul>

<p class=MsoNormal style='text-align:justify'><span style='font-family:Tahoma;
mso-bidi-font-family:"Times New Roman"'>The last one would be great!<o:p></o:p></span></p>

<p class=MsoNormal style='text-align:justify'><span style='font-family:Tahoma;
mso-bidi-font-family:"Times New Roman"'>Whatever functionality you think is
interesting to you, might be to a lot of other people. Don�t hesitate to email
us or to develop it yourself if you can. </span></p>

<h2 style='text-align:justify'><a name="_Toc124510201"><u><span
style='font-family:Tahoma;mso-bidi-font-family:Arial'>8. FAQs.</span></u></a><u><span
style='font-family:Tahoma;mso-bidi-font-family:Arial'><o:p></o:p></span></u></h2>

<ul style='margin-top:0in' type=disc>
 <li class=MsoNormal style='text-align:justify;mso-list:l3 level1 lfo6;
     tab-stops:list .5in'><b style='mso-bidi-font-weight:normal'><span
     style='font-family:Tahoma;mso-bidi-font-family:"Times New Roman"'>I can�t
     see the reference in my document after I tried to insert it</span></b><span
     style='font-family:Tahoma;mso-bidi-font-family:"Times New Roman"'>.<o:p></o:p></span></li>
</ul>

<p class=MsoNormal style='margin-left:.5in;text-align:justify'><span
style='font-family:Tahoma;mso-bidi-font-family:"Times New Roman"'>Make sure
that your reference is in the �References� key of your database (Keys are
displayed on the left column of Bibus window).<o:p></o:p></span></p>

<p class=MsoNormal style='margin-left:.5in;text-align:justify'><span
style='font-family:Tahoma;mso-bidi-font-family:"Times New Roman"'><o:p>&nbsp;</o:p></span></p>

<ul style='margin-top:0in' type=disc>
 <li class=MsoNormal style='text-align:justify;mso-list:l3 level1 lfo6;
     tab-stops:list .5in'><b style='mso-bidi-font-weight:normal'><span
     style='font-family:Tahoma;mso-bidi-font-family:"Times New Roman"'>Why
     can�t I see the duplicate information, even after pre-formatting the
     citations?<o:p></o:p></span></b></li>
</ul>

<p class=MsoNormal style='margin-left:.5in;text-align:justify'><span
style='font-family:Tahoma;mso-bidi-font-family:"Times New Roman"'>The duplicate
information is added after finalization.<o:p></o:p></span></p>

<p class=MsoNormal style='margin-left:.5in;text-align:justify'><span
style='font-family:Tahoma;mso-bidi-font-family:"Times New Roman"'><o:p>&nbsp;</o:p></span></p>

<ul style='margin-top:0in' type=disc>
 <li class=MsoNormal style='text-align:justify;mso-list:l3 level1 lfo6;
     tab-stops:list .5in'><b style='mso-bidi-font-weight:normal'><span
     style='font-family:Tahoma;mso-bidi-font-family:"Times New Roman"'>Why do
     MS Word windows minimize when I try to pre-format or to finalize my paper?<o:p></o:p></span></b></li>
</ul>

<p class=MsoNormal style='margin-left:.5in;text-align:justify'><span
style='font-family:Tahoma;mso-bidi-font-family:"Times New Roman"'>MS Word
processes information faster when minimized. Therefore you save some time by
keeping it this way. Minimization is not a functional requirement; it is just
faster but also much safer. Since Bibus works with the active document and in
the case you want to reactivate a document during processing (when you have the
progress bar), make sure that you reactive the correct <span class=GramE>one,</span>
or you will mess up with your documents.<o:p></o:p></span></p>

<p class=MsoNormal style='margin-left:.5in;text-align:justify'><span
style='font-family:Tahoma;mso-bidi-font-family:"Times New Roman"'><o:p>&nbsp;</o:p></span></p>

<ul style='margin-top:0in' type=disc>
 <li class=MsoNormal style='text-align:justify;mso-list:l3 level1 lfo6;
     tab-stops:list .5in'><b style='mso-bidi-font-weight:normal'><span
     style='font-family:Tahoma;mso-bidi-font-family:"Times New Roman"'>Why does
     it take so long to insert a reference?<o:p></o:p></span></b></li>
</ul>

<p class=MsoNormal style='margin-left:.5in;text-align:justify'><span
style='font-family:Tahoma;mso-bidi-font-family:"Times New Roman"'>If you have
more than 150 references and working with a number style ([1] for the first
inserted citation etc�), for each insertion Bibus looks for duplicates so that
it assigns the correct numbers to your newly inserted reference. This loop is
time consuming (few seconds). You will soon be able to turn this feature off,
by unchecking in MSWord menu the option �update citation on insert� (next
version).<o:p></o:p></span></p>

<p class=MsoNormal style='margin-left:.5in;text-align:justify'><span
style='font-family:Tahoma;mso-bidi-font-family:"Times New Roman"'><o:p>&nbsp;</o:p></span></p>

<ul style='margin-top:0in' type=disc>
 <li class=MsoNormal style='text-align:justify;mso-list:l3 level1 lfo6;
     tab-stops:list .5in'><b style='mso-bidi-font-weight:normal'><span
     style='font-family:Tahoma;mso-bidi-font-family:"Times New Roman"'>Why the
     references get un-fused each time I insert a reference?<o:p></o:p></span></b></li>
</ul>

<p class=MsoNormal style='margin-left:.5in;text-align:justify'><span
style='font-family:Tahoma;mso-bidi-font-family:"Times New Roman"'>For each
insertion, Bibus checks that the format for each reference is correct,
reassigns it and then inserts the reference. This is done to update the
citation style in case you change the bibliographic style for a document.<o:p></o:p></span></p>

<p class=MsoNormal style='text-align:justify'><span style='font-family:Tahoma;
mso-bidi-font-family:"Times New Roman"'><o:p>&nbsp;</o:p></span></p>

<ul style='margin-top:0in' type=disc>
 <li class=MsoNormal style='text-align:justify;mso-list:l3 level1 lfo6;
     tab-stops:list .5in'><b style='mso-bidi-font-weight:normal'><span
     style='font-family:Tahoma;mso-bidi-font-family:"Times New Roman"'>How can
     I un-fuse my references after I have done a pre-format?<o:p></o:p></span></b></li>
</ul>

<p class=MsoNormal style='margin-left:.5in;text-align:justify'><span
style='font-family:Tahoma;mso-bidi-font-family:"Times New Roman"'>You can
either insert a reference and remove it, or you can go to menu MSWord &gt;
Update Citations<o:p></o:p></span></p>

<p class=MsoNormal style='text-align:justify'><span style='font-family:Tahoma;
mso-bidi-font-family:"Times New Roman"'><o:p>&nbsp;</o:p></span></p>

<ul style='margin-top:0in' type=disc>
 <li class=MsoNormal style='text-align:justify;mso-list:l3 level1 lfo6;
     tab-stops:list .5in'><b style='mso-bidi-font-weight:normal'><span
     style='font-family:Tahoma;mso-bidi-font-family:"Times New Roman"'>I have
     changed my style and want to see the updated document version?<o:p></o:p></span></b></li>
</ul>

<p class=MsoNormal style='margin-left:.5in;text-align:justify'><span
style='font-family:Tahoma;mso-bidi-font-family:"Times New Roman"'>You can <span
class=GramE>either insert a reference and</span> remove it or you can go to
menu MSWord &gt; Update Citations. <span class=GramE>Then MSWord &gt; Update
Bibliographic Index.</span> Alternatively you can just pre-format your document
(the window will minimize; citations will be fused) <o:p></o:p></span></p>

<p class=MsoNormal style='margin-left:.5in;text-align:justify'><span
style='font-family:Tahoma;mso-bidi-font-family:"Times New Roman"'><o:p>&nbsp;</o:p></span></p>

<ul style='margin-top:0in' type=disc>
 <li class=MsoNormal style='text-align:justify;mso-list:l3 level1 lfo6;
     tab-stops:list .5in'><b style='mso-bidi-font-weight:normal'><span
     style='font-family:Tahoma;mso-bidi-font-family:"Times New Roman"'>I don�t
     find the style for the journal to which I intend to send my draft.<o:p></o:p></span></b></li>
</ul>

<p class=MsoNormal style='margin-left:.5in;text-align:justify'><span
style='font-family:Tahoma;mso-bidi-font-family:"Times New Roman"'>That�s a
great occasion for you to get familiar with style definition. It is likely that
the number or journal styles supported will increase in the near future due to
bibMSW. And please send us your style file. It takes about 20 min to create a
style the first time, 3 minutes once you know to do it. Believe me, learning
how to do this is very worthwhile. For more information on styles, see <a
href="http://bibus-biblio.sourceforge.net/html/en/usingOOo.html#mozTocId283248"
target="_blank">here</a>.<o:p></o:p></span></p>

<p class=MsoNormal style='margin-left:.5in;text-align:justify'><span
style='font-family:Tahoma;mso-bidi-font-family:"Times New Roman"'><o:p>&nbsp;</o:p></span></p>

<ul style='margin-top:0in' type=disc>
 <li class=MsoNormal style='text-align:justify;mso-list:l3 level1 lfo6;
     tab-stops:list .5in'><b style='mso-bidi-font-weight:normal'><span
     style='font-family:Tahoma;mso-bidi-font-family:"Times New Roman"'>One of
     my references doesn�t appear in the bibliographic index?<o:p></o:p></span></b></li>
</ul>

<p class=MsoNormal style='margin-left:.5in;text-align:justify'><span
style='font-family:Tahoma;mso-bidi-font-family:"Times New Roman"'>This bug has
never been observed but can hardly happen and is theoretically possible.
Without getting into details do the following:<o:p></o:p></span></p>

<p class=MsoNormal style='margin-left:.5in;text-align:justify'><span
style='font-family:Tahoma;mso-bidi-font-family:"Times New Roman"'>1) Open your
document<o:p></o:p></span></p>

<p class=MsoNormal style='margin-left:.5in;text-align:justify'><span
style='font-family:Tahoma;mso-bidi-font-family:"Times New Roman"'>2) Hit
ALT+F9, a list of fields appears. Each reference starts with �{ADDIN BibusRef�.
Each section contains a list of XML type key/values (&lt;Author&gt; etc�).
Locate your reference by searching its title for example.<o:p></o:p></span></p>

<p class=MsoNormal style='margin-left:.5in;text-align:justify'><span
style='font-family:Tahoma;mso-bidi-font-family:"Times New Roman"'>3) Once the
reference is found go to its identifier (between the &lt;Identifier&gt; and
&lt;/Identifier&gt; tags). The Id might be something like Einstein#20. <o:p></o:p></span></p>

<p class=MsoNormal style='margin-left:.5in;text-align:justify'><span
style='font-family:Tahoma;mso-bidi-font-family:"Times New Roman"'>4) Change the
number to another number that you would be sure not to find for any other
reference in the document (try a negative number: Einstein#-20). If you cite
the reference more than once, make sure to do so for each citation.<o:p></o:p></span></p>

<p class=MsoNormal style='margin-left:.5in;text-align:justify'><span
style='font-family:Tahoma;mso-bidi-font-family:"Times New Roman"'>This bug
never occurred and is unlikely to occur. This solution should solve the <span
class=GramE>problem,</span> however this couldn�t be tested yet. If you happen
to have this bug, please send us 1) You document (will be kept confidential),
2) Your database of references 3) The Style file you used and 4) The number of
different computers used for this document with Bibus (1,2�). <o:p></o:p></span></p>

<p class=MsoNormal style='margin-left:.5in;text-align:justify'><span
style='font-family:Tahoma;mso-bidi-font-family:"Times New Roman"'>In the worst
case scenario, you can still add it yourself after finalization.<o:p></o:p></span></p>

<p class=MsoNormal style='margin-left:.5in;text-align:justify'><span
style='font-family:Tahoma;mso-bidi-font-family:"Times New Roman"'><o:p>&nbsp;</o:p></span></p>

<ul style='margin-top:0in' type=disc>
 <li class=MsoNormal style='text-align:justify;mso-list:l3 level1 lfo6;
     tab-stops:list .5in'><b style='mso-bidi-font-weight:normal'><span
     style='font-family:Tahoma;mso-bidi-font-family:"Times New Roman"'>Bibus
     bugged, What should I do, how can solve the problem?<o:p></o:p></span></b></li>
</ul>

<p class=MsoNormal style='margin-left:.5in;text-align:justify'><span
style='font-family:Tahoma;mso-bidi-font-family:"Times New Roman"'>As newly
develop programs that will be tested by a lot of people you will certainly
encounter bugs. Usually, these are not fatal, should not harm your document and
by retrying, or looking for the reference(s) for which the bug occurs you will
be able to solve the problem yourself. In some cases, you might not be able to
do so. Then copy the error message sent to you, and email it to us along with
your document, your database/Style file used, and describe the sequence of
events that lead to your bug. We will try to reproduce it, and then solve it.<o:p></o:p></span></p>

<p class=MsoNormal style='text-align:justify;tab-stops:97.5pt'><o:p>&nbsp;</o:p></p>

</div>

</body>

</html>
bibus-doc-en 1.5.2-4 / usr / share / doc / bibus / html / en / bibMSW.htm
