-
Notifications
You must be signed in to change notification settings - Fork 6
Tutorials
To create a new project, choose Menu / File / Project / New. The Project Properties dialog opens.
Type the name of the project, optionally make settings and add some books, and click OK.
Adding books to the project can be done in two ways:
-
Add templates for the books through menu File - Project - Properties. The templates contain some markers, chapter and verse numbers, and in some cases a bit of example text.
-
Add existing books by importing them into the project.
In menu File - Project - Properties, books can be removed.
In the editor, just press Ctrl+O, or do it through menu File - Project - Open, and you'll be presented with a list of projects that can be opened. Click the project that you wish to open, or otherwise type the first few characters of the name of that project, and then press Enter.
A project can be closed with Ctrl+W, or via the menu, File - Project - Close.
A project can be copied in its entirety to a new name. See menu File - Project - Copy to. This new name will then be an exactly copy of it and can from now on be dealt with as all other projects.
Through menu File - Project - Delete a project can be deleted. The project that is currently open is not shown in the list of projects that can be deleted. Non-editable projects are not shown either.
Printing a project goes via menu File - Print, then to select "Project".
In that dialog you've the option to include or exclude certain books, and to set which portion of any book will be printed. Remove the tick to exclude it. Focus it, and then press the appropriate button to select the portion to be printed.
Once printed it will open in a pdf viewer, and you can print the whole project or part of it from there.
See also Printing.
A whole project can be compared to another one. Any differences are highlighted.
Words that have been added are printed in bold. Words removed will appear stroked out.
If only the changes are printed, then the references, that have a change, will be loaded in the Reference Area for easy review.
See the File menu, then menu Print, then Parallel Bible.
The so called "Parallel Bible" contains parallel versions for only one book, and is intended for producing worksheets for use during translations sessions. The members of the team each get a pile of sheets with all relevant versions printed in parallel on it, verse by verse. Without these sheets each member might have a lot of Bibles strewn about him on the desk, but with these sheets things get more compact. And there will still be Bibles enough on the desk, as many Bibles are not available in electronic format, and hence cannot be printed on the worksheets.
Commentaries can also be printed on the worksheets, provided they are available as projects in Bibledit.
The Parallel Bible will be printed with the currently opened project at the top, and it will print the book that is currently opened. Therefore, to change the first project on the sheets, just open another project, and for changing the book to be printed, just go to another book.
To add another project to your Parallel Bible, press the "Add project" button and select the project to be printed. Added projects can be removed with the Remove button.
Normally all parallel verses are kept together on one page for greater readability. Depending on the number of Bibles printed in parallel, this may leave a lot of whitespace at the bottom of the page. To save paper you can uncheck the option in the dialog, so that the parallel verses no longer are kept together and the paper is filled with text to the bottom.
You can set which portion of the text to print. There are two controls that influence this.
The "Change" button for the portion. This selects which portion to print.
The "Include verses 0" checkbox, whether to include the verses 0 from any of the chapters. Verse 0 is anything before verse 1.
At the end press button Ok to get the Bible in .pdf format.
Add a new chapter to a book by inserting the "c" USFM marker, or by choosing Insert - Chapter.
To remove a chapter from a book, choose Edit - Chapter number. In the dialog that comes up, choose "Delete the chapter" and press OK. The chapter that is currently visible will be deleted.
To change the number of a chapter, choose Edit - Chapter number. In the dialog that comes up, choose a new chapter number from the list or enter it manually, and then press OK.
See Backup.
See Changes.
##General
During the process of translation many notes will be made that related to the project.
Project notes are stored in a database, and are independent of any Bible text. That is, whichever project is opened or closed, the notes remain the same.
To make a new project note press Ctrl+N.
To edit an existing project note click on the blue reference(s) for that note.
When creating a new note or editing an existing one, the project notes window splits up into two so as to make space for a couple of controls.
Project notes can be deleted by clicking on the blue [delete] link.
Some keyboard shortcuts help while editing notes. An example will show how: The user edits the text of a project. To make a new note, he presses Ctrl+N. He types some text in the note. If he wishes to change to category of the note, he presses Alt+A, then Enter to open the list of categories, then he makes a selection with Up Arrow or Down Arrow and presses Enter to confirm the selection. If he wishes to add some references, he pressed Alt+R and types some references. Alt+O saves the note, and takes the user back to where he was editing the text. Ctrl-I puts the text in italics, Ctrl-B makes it bold, and Ctrl-U underlines it.
When a project note is being edited, the creator of the note can be retrieved through menu View / More information on current note. Other information about this note is visible there as well, like the date it was created, and when it was edited.
Each note falls into a category. The various categories and the default category can be set in the preferences.
Menu / Edit / Find in Project notes (Alt+E, N) allows to do Simple searches in the Project notes.
This tool searches exacty (except case sensitive) for the sequence of characters entered into the "Search for" box, punctuation marks and spaces included. Case sensitive can be switched on or off.
Project notes usually have one reference. This is the one for which the note was created. But additional references can be added as well.
These references are shown attached to each note.
There are two ways to get these notes into the references window.
-
Open a note to edit it. In the menu choose Edit - Get references from project note.
-
Click on the blue word [references] of a note.
As a result the references will be loaded in the references window. Once there they can be activated and the text belonging to that reference will appear in the text editor.
Many people have one project with the actual text, and a separate project for their project notes. There is a historical reason for doing so. This separate project may have checking questions, answers from native helpers, a history of different renderings, commentary support, notes following consultant checks, and so on.
It would be a lot of work to copy and paste these notes into the project notes one verse at a time.
The tool "Transfer text to project", under the Tools menu, helps you with this.
It transfers all text that is in the currently opened project into the project notes.
It takes a good while to do this.
If project notes need to overlap the chapter boundaries, the reference can be manually entered like, for example: Luke 2:2-3:3. Bibledit will divide this into two parts: Luke 2 verse 2 to the end of the chapter, and Luke 3 verse 1 to 3.
The settings for which notes to show and how are in the View menu.
Project notes can be exported into some formats.
-
Bibledit Notes version 3. This is the format used by the current version of Bibledit. In other words, notes exported through this option can be imported in Bibledit.
-
ScriptureNotes version 2.0. Notes exported in this format can be imported by Translation Notes Editor 6.0.
To see how these formats looks, just export some text and open the exported text in a text editor.
The notes that you make on your computer can be shared with other members of the team. These notes you make will then also be available to the members of the team, and the notes made by any member of the team will also become available to you.
You can set the sharing up through the Remote Repository Assistant. Normally this assistant sets up project sharing. But it can also set up notes sharing. Just make the appropriate selection at the start of the assistant. It will be good to read the entire section about Collaboration if you need to set it up, since it fully explains the technical details.
Notes are stored in flat files, but selected from an index. If the index for some reason gets corrupted or out of sync, then you can recreate it by either deleting the index manually from directory ~/.bibledit/notes and then restarting Bibledit, or by setting the sharing up again through the remote repository assistant.
Menu File - Project notes - Send / Receive to a manual sync of your notes with the remote repository. Normally the sync is done automatically, though, by default it is done every hour, but you can change this in the remote repository assistant.
A Bible note is a note that goes in the Biblical text. It can be a footnote, or a cross reference, or an endnote.
Bible notes can be inserted manually by applying an appropriate note style. For example, if the "f Footnote" style is applied, then a window comes up allowing insertion of this footnote. The same applies to endnotes and crossreferences.
Bible notes are marked by a asterisk or character in the editor. Its text is visible at the bottom of it.
The asterisk corresponds to no caller (-), the characters to automatic callers or a given caller in the text.
Removing a note works as you would remove any text.
Notes can be cut and paste in a text (which is only useful in the same verse, if a verse-reference (\fr or \xo) is included.
While editing a note, pressing Page Up takes you back to the main body of text, to the place where the footnote starts.
If a project is printed, it will show the footnotes, endnotes, and crossreferences. Printing a list of references does not.
Footnotes and crossreferences normally appear at the bottom of the page, inside the column they belong to.
Endnotes normally are printed at the end of all other text. This can be changed in the stylesheet. Edit the style for \fe to change that. The other options are to print them at the end of each book, or upon encountering a certain marker in the text.
Placing endnotes upon encountering a certain marker is the most flexible option. It allows endnotes to be placed exactly where you want them. If this option is switched on, it normally places them where marker \zendnotes is found in the text. You can insert the \zendnotes anywhere, and notes collected thus far will be dumped there. The \zendnotes marker can be repeated as often as you wish. The \zendnotes marker needs to be typed by hand because it is not in the stylesheet.
A Bible note has a caller. The style of the caller can be set in the markers, see USFM under marker \f. For crossreferences set it under marker \x.
A "+" prints a caller with automatic numbering, a "-" prints no caller at all, and any other character prints that character as a caller.
The automatic numbering can be influenced in the stylesheet, under marker f for footnotes and under marker x for crossreferences. The numbering 1, 2, 3 ... should be clear, and the numbering a, b, c ... follows the alphabet, and after reaching the z it starts all over again. A user defined numbering sequence can be given too. When for example §†* is given there, the numbering goes like §, †, *, §, †, *, and so forth. Any sequence of characters can be used.
Optionally the automatic numbering can be restarted every chapter or book.
The automatic numbering of endnotes is restarted whenever the notes are printed, either at the end of the book, the end of everything, or upon encountering a certain marker. See the style \fe to set this.
For a footnote, the \ft style has a full paragraph setting in the stylesheet. Here you can set how the normal footnote paragraph is going to look. For a crossreference, set the style under marker \xt.
For a new paragraph in the footnote, the style can be set under the \fp marker.
Bibledit can print things like a list of references along with the text, or the whole project, or part of the project, and so on.
Printing is done this way: Bibledit generates a .pdf file, and then opens this file in a pdf viewer. From there it can be printed.
The font to be used can be set under menu View / Font & Colour / Text.
Additional fonts could be looked for by searching the internet for "Free Unicode fonts" or at http://scripts.sil.org.
In the dialog where the font can be selected, there is also a setting for the line height, in percentages. Normally it is on 100%. Setting it to e.g. 200% gives the line a double height. This would for example allow for text and notes to be written between the lines on worksheets.
These are footnotes, endnotes, and crossreferences. Location of .pdf files
The .pdf file for printing a project usually is temporary directory/document.pdf.
Normally text is laid out in two columns. The stylesheet editor allows the "span columns" property to be set. This means that a certain piece of content spans the two columns. Biblical content honours this setting, but content from the Front Matter and the Back Matter is laid out in one column.
Normally Bibledit prints all the books one after the other, without starting them on a new page. This behaviour is implemented so that normally not too much paper is used. Bibledit can be set to print each new book on a new page, or, going one step further, to have each book start on an odd page. Settings for this are in the stylesheet, under the \id marker.
Some styles have the "print" property in the stylesheet editor. If "print" is unticked, then this style won't be printed. This comes in useful when there is some data in the text that you don't want to print this time. Footnotes, for example. The quickest way of doing this is to make two stylesheets. One full stylesheet that prints everything. And one adapted stylesheet that doesn't print footnotes. Just opening another stylesheet in the editor, and printing, makes it work.
Normally words are not hyphenated. But if a word does not look well on the printout, and hyphenation is needed, the user can insert a soft hyphen in that word. The "Insert" menu caters for that.
Bibledit uses an internal engine to lay the text out on the pages. Under normal circumstances the commands that are sent to that engine during printing remain invisible. But there is a setting to make these commands visible, to review or edit them. The setting is under menu Preferences / Printing, tab "Formatter".
Bibledit can also make use of the ptx2pdf macros together with the XeTeX typesetter. More information is provided by UBS. If you have printed something through the ptx2pdf macros, then the files that control this printout are available in /tmp/bibledit/xetex. If you run "xetex document.tex" within that directory, you can do the typesetting again. You can modify the control files there, so as to fine-tune it to what you need. To do complex non-Roman scripts like e.g., Farsi is, you will need the latest version of XeTeX. The one that gets install with the current version of Ubuntu (9.10) may not be good enough. You can pull the most up to date version from the SIL repo. (deb http://packages.sil.org/ubuntu karmic main). With XeTeX you can also print numerals in a different script. See the Questions for more information.
See also:
Questions
Print portion
Bibledit can assist you in planning the work.
There are three places in the Bibledit menu that are relevant to planning.
-
Preferences / Planning. This is for setting it up.
-
Edit / Planning. This is for editing the planning and status.
-
View / Planning. This shows the planning and reports on progress made.
How it works is going to be explained below by an example.
Go to menu Preferences / Planning. The Planning Setup dialog shows.
The first thing to do in that dialog is to indicate when the project was started.
After that you can enter the tasks that the project consists of. Let's add two tasks, "First draft", and "Final draft".
The last thing to do is to indicate how much time each task takes to complete one chapter. Let's enter three days per chapter for the first draft, and two days per chapter for the final draft.
This sets you up for making a planning and for reporting the progress.
Once you have set up everything, the next thing to do is to update the progress of the work. This can be done through menu Edit / Planning. If this is chosen, a dialog, called "Planning Edit" shows.
You can edit the project's status. This means that you can tick off which bits of work have been completed.
For making a planning for the shorter term, you can enter which task are supposed to be done.
In order to view the status report, choose View / Planning. This should give a report of the progress you make, and the planning.
Through menu Edit the Find menu can be opened. The same can be done through the keyboard shortcut Ctrl+F.
A list of hits will show in the references window.
Menu / Edit / Find (Ctrl+F) searches exacty (except case sensitive) for the sequence of characters entered into the Search for box, punctuation marks and spaces included. Case sensitive can be switched on or off. Searching can be limited to the current book.
Example: Searching for "ue. t" (without the quotation marks) shows all the references with the words: true. The.
Note that for the text to actually display, you have to hit one of the search results.
Menu / Edit / Find (Ctrl+F, Ctrl+F) allows more complex searches than the Basic Find:
-
Search box to enter text.
-
Case sensitive: on or off.
-
Search in curent book only: this limits searching to the current book.
-
Interprete * and ? as wildcards: on or off.
-
Match start of word: on or off.
-
Match end of word: on or off.
-
Select books: some books (all), for details see Select books.
-
Which area of the text to search in.
-
What to do with the search results. This gives the choice how the results will show up in the references window, see Loading results below.
There are two wildcards. The ? and the *. The ? means "any single character". If one were to search for "p?t", and ticks the option for wildcards, then the search will hit results like "pit" and "put". The * works similar, but means "zero or more characters".
Searches can be done in certain areas of the text. When searching in the raw USFM text, then one searches in the text as it is stored, e.g. one can search for markers too, like \add. When searching in all the text except the USFM codes, one searches in the text as it will appear on the paper when printed. This means that searching for markers is not possible, as these will be hidden on the paper. When searching in certain categories, one can limit searches to, let's say, only the introductions, or only the verse text, or only headings and identifiers, and so forth.
Once an advanced or BibleTime search has been done, one can decide how they interact with what is already in the references window.
-
The search results can simply be loaded in the references window, and so replace anything that is already there.
-
Or the search results can be added to the references already there.
-
Or they can be removed from the references already loaded.
-
Sharing the search results with what is already in the references window means that only the references that are the same will be kept in the references window, and the other ones will be discarded.
In the case that in a Special Find the option: 'Share them with the ones already in the references window' is chosen, and this special find with this option is repeated several times, several groups of characters can be highlighted in the text editor (as a result from the different searches) when a reference is activated in the references window.
Menu / Edit / Find and Replace (Ctrl+R) searches for and replaces text. It goes like this:
Press Ctrl+R to start the find & replace. Enter the word to search for, and the word to replace it with. Optionally make settings like case sensitive, searching in current book and/ or chapter, or select the books to operate on. Press Find to start the operation.
A new dialog will open. It shows the verse to be affected, e.g. Esther 6:5. It also shows the original text as it is before changing. This is in the top half of the dialog. Below that it shows the suggested text as it would be after change. If you want to make changes to the suggested replacement, then you can edit this in the lower half of the dialog.
Once you are satisfied that the change is going to be the one that you want, then you can press button Yes. Press No if you don't want to change this verse. Or press Cancel to stop changing. If you press button All, it would change this verse and all following relevant verses. Be careful with this option. It could change instances that you may not have wanted to change.
See Project Notes for more information.
Most of this tutorial applies to Linux but some things may be slightly different
Lesson 1 - Open, Close, and Help
To start using Bibledit: Click Start->All Programs->Bibledit->Bibledit
You will see the Bibledit Menu window open up
To get help using Bibledit: Click Help->Contents
The help webpage will open: Click the Tasks or the Tools link
Bibledit help has 2 main sections Tasks and Tools
The Tasks section discusses general Bibledit tasks that a user will typically want to do.
The Tools section describes each Bibedit menu item.
For example, if I click Tasks and then Import then the help page shows a variety of topics about importing texts and where to get some standard Bible to import. If I click Tools and then Import then the help page shows a description of the Import text dialog that appears when you choose the File->Project->Import menu item.
To close Bibledit click the X in the upper right corner of the Menu window
Lesson 2 - New Project, templates, navigation and goto
Open Bibledit.
Click File->Project->New: This will open the New Project Dialog
Choose Books:
Click OK: This will create the new project
The book of Matthew will open in a window below the menu window.
To go to a different chapter, choose the chapter number from the Menu window.
The fastest way to jump to a new reference in a different book is to use the Goto command. Press CTRL+G: You will see the Goto reference dialog box.
Practice typing in verses and jumping to a new verse and typing some more.
To close a project simply close the text window. A project is automatically saved as you work on it.
To open a project click File->Project->Open and choose the project you want to open
Printing
To print a project in Bibledit click File->Print
Lesson 3 - Editing (styles) /searching/footnotes
Styles are used to format text in Bibledit.
To open the styles window in Bibledit click File->Styles->Open
Select the text that you want the style to be applied to and then double click the style name
To add a footnote place the cursor at the end of the word to be footnoted and double click the footnote style
Click ok
Type the note after the footnote number
To delete a footnote, delete the footnote number from the Bible text.
To search go to Edit->Find or CTRL+F
Type in the term you want to search for.
The references window will open with a list of references where that word occurs. Double click the reference to jump to that verse.
Lesson 4 Multi views/project notes/import
To open a second project, go to File->Project open and choose another project to open
When 2 projects are open they both move to the same reference.
.A project note is a note about the current passage. These can be reviewed later for checking
To create a project note press CTRL+N
The project notes window will open.
Type the note, choose a category and click ok
To review all the project notes click View->Project notes
Choose the option: “any verse�,
Click OK
Lesson 5 checking/verse/keyterm/Export/Quotation marks
To check if the chapter and verse numbers are correct click Check->Chapters and Verses. A list of missing references will show in the references window
Keyterm check
To check keyterms click Check->Key terms. This will show the keyterms window
Select a keyterm
Double click the correct word in the red verses
Export for back translation
File->Project->Export->Unified Standard Format markers
Click your username in the left column, choose My Documents->Adapt It Unicode Work->Export. Then click Open
Quotation marks
Use < and > for single opening and closing quotes and << and >> for double opening and closing quotes. Bibledit will automatically replace these symbols with curved quotation marks when the text is printed or exported.
Visit the web page for Bibledit-Desktop at bibleditdesktop.org