previous Chapter I.2

Writing a simple text

next


Starting TeXmacs up

Assume that you have started up TeXmacs, so that you have a window like below on your screen:

Starting TeXmacs

Before you start typing a new text, we recommend you to perform the following steps:

In this chapter, we will only describe the first step. In chapter I.4, we will discuss how to type texts in foreign languages. In chapter II.1, we discuss the importance of document styles. The default document style is a letter.

Giving your document a name

We recommend you to give your document a name before you start to edit it, by saving it under a new name. This is achieved by selecting the Save buffer as item in the save icon icon menu or the Save as item in the File menu: press the left mouse button on save icon, move your cursor to Save buffer as while maintaining the left mouse button pressed, and release the left mouse button.

Save TeXmacs file (step 1)

Notice that you could have achieved the same thing by simultaneously pressing the shift and the F3 keys, as suggested by the help balloon. This help balloon automatically shows up when leaving the mouse pointer on the Save buffer as for a while. After you released the left mouse button, a new window of the following form pops up:

Save TeXmacs file (step 2)

This window is also called a file browser, because you can interactively choose a file name and a directory where to save your file, by using the keyboard or the mouse. In the example, .., images, phonetic and test are the parent directory and subdirectories of the current directory. The file demo.tm is an already existing TeXmacs file in the current directory. The buttons Home and Texts can be used to return to your home directory or a special directory for TeXmacs documents.

In order to finish the action of giving our text a name, we just type test.tm in the File: field and press on Ok:

Save TeXmacs file (step 3)

We notice that you should always let your file name end by the .tm suffix, so that anyone can recognize that your file is a TeXmacs document. After giving your text a name, your main window should look like

Save TeXmacs file (step 4)

First of all, you may notice the change of the title of your window. Furthermore, a message on the footer confirms the name change.

Writing a simple text

Once you have given your document a name, you may start to type your text. In chapter 4, we will explain how to type special characters, which are necessary for writing texts in foreign languages. The following is a sample text, which you may try to type as an exercise:

A simple text

When you are done with typing, we recommend you to first save your document, using the Save buffer item in the save icon icon menu, or by pressing the F3 key. A message on the footer should confirm the success of this operation:

Save the simple text

For your safety, TeXmacs actually autosaves your document every two minutes. If you forgot to save your document before closing TeXmacs, or if your computer is unpowered for some reason, then you will be prompted whether you want to retrieve the last unsaved changes in your document as soon as you try to load it. Again a message on the footer confirms autosaving:

Autosave the simple text

When you are done with typing, you usually want to print your document out. This can be done by selecting the Print all item in the print icon icon menu, or by pressing the F4 key. Before printing, it might be that you want to setup your printer using the entries in the File -> Page setup menu. You may specify a Printing command (like lpr), the Paper type of your printer (like a4 in Europe or letter in the USA) and the printer's precision in dots per inch (600 is default).

In order to retrieve your text after closing TeXmacs, you first have to push the Load buffer item in the load icon icon menu or hit the F2 key. Next, you may select your file using the file browser. In our example, the file test.tm indeed appears in the file browser and we may retrieve it by rapidly clicking twice on it.

Retrieve the simple text


previous next


Copyright (C) 1999, 2000 by Joris van der Hoeven.

This webpage is part of GNU TeXmacs and the larger GNU project. Verbatim copying and distribution of it is permitted in any medium, provided this notice is preserved. For more information or questions, please contact Joris van der Hoeven.

Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111, USA