# Authorea

## Why [Authorea](https://authorea.com/)?

Collaborative writing can be challenging, especially when your squad is working on the same file at the same time. But not in MedisTree, because we wish to optimize your working time by minimizing any technical hassle :wink: For collaborative writing, we encourage the use of [Authorea](https://authorea.com/). This platform is intended for scientific writing and has extensive capabilities in easing your writing flow.

## Steps to use [Authorea](https://authorea.com/)

Remember how difficult it is to manage your reference? Or when you have to use different citation style? Or when you receive a file from your squad and all the citation seems to be broken? Fret not, with [Authorea](https://authorea.com), you can forget about the technical difficulties and keep focusing on writing.

### Creating the document structure

After you are logged in to [Authorea](https://authorea.com), you can choose to create a new document. Here, we would recommend you creating the document structure. Having a structured document will help you and your squad to achieve the goal faster! By default, we are using the following structure (it may vary depends on the client's requests):

```
- Section/first heading (H1)
  - Subsection/second heading (H2)
  - Subsection
    - Subsubsection/third heading (H3)
    - Subsubsection
    - Subsubsection
- Section
...
```

In the following screenshot, the document structure is:

```
- BAB I: PENDAHULUAN
  - Latar Belakang
  - Rumusan Masalah
  - Tujuan Penelitian
  - Manfaat Penelitian
    - Manfaat Teoretis
    - Manfaat Praktis
  - Sistematika Penulisan
- BAB ...
```

Notice that on the top bar there is a button named `h1`, `h2`, and `h3`. Those represent the first, second, and third headings, respectively. You can structure the document using these buttons.

![Structuring your document](/files/RCHiFFHlCuRu6nqbHcRJ)

### Inserting a new text block

After creating the document structure, it is **important** to insert a new block. Blocks in [Authorea](https://authorea.com) can be divided into `LaTeX`, `Markdown`, `Text`, and `Code Block`. If you are not familiar with *any of these* terms, that's totally fine! It means, most of the time, you will likely only use the `Text` block.

To insert a new `Text` block, first you need to place your cursor at the end of a paragraph/section name. Then, you will click on `Insert` --> `Text` and [Authorea](https://authorea.com/) will create a new block where you can start writing!

Please note that, only **one user** can access and edit **one block** at one time! Therefore, it is crucial to enter a new block when you are starting a new paragraph.

![Inserting a new text block](/files/jKbvPdH0bUSjZ7ij3LBH)

### Finding citation

Well, now you have started writing and I'm sure your head is filled with a lot of brilliant ideas :beers: To support those ideas, you might need to cite one or two articles. To do so, we recommend looking for a suitable citation from Google scholar. After you find the right one, click on the `Cite` button right below it.

![Searching for citation](/files/GVzFh7KZfal6w3EhuzpM)

When you click the `Cite` button, there will be a pop-up window with this interface (more or less). Then you will need to click on `BibTeX` button.

![Extracting the citation as BibTeX](/files/Md5AUzptpQgp3XQKQJ4Q)

Clicking the `BibTeX` button will lead you to a page containing your reference content. Now you need to **copy** all the good stuffs!

![Copying the BibTeX content](/files/atIq6C4vBqRxa3xQYLj6)

### Adding citation in [Authorea](https://authorea.com/)

Go back to your document. Click `Insert` --> `Citations`, then you will be greeted by the following pop-up window. Click the green text `Add citations from reference managers`.

![Adding a new citation](/files/jawC3q0WgnuLS5ZMGInT)

Paste the `BibTeX` you previously copied into the box, then click `SUBMIT BIBTEX`.

![Using BibTeX to add a new citation](/files/NxcxVTXDcsXM4rv7tjOM)

Next, you click the `Add Citation` button.

![Add the parsed BibTeX as a citation](/files/pd8dBAidvfmoSbGSx755)

### Insertion citation

Now, you can add the citation to your document. If you don't wish to add more, just click the `Cite and Close` button.

![Citing one article](/files/8kogVIhbP4IgZRrilb49)

### Having multiple citation

You will most likely need to cite multiple papers, which can be easily handled by [Authorea](https://authorea.com/). Click `Insert` --> `Citations`, then choose `Local`. Here you can find citation you have previously added.

![Finding locally-saved citation](/files/1eg7fRx0IJsh60EkHGYd)

You can choose as many citation as you need, you can even add the new one while you are at it! To wrap it up, just click `Cite and Close` and *voila* you will have a formatted citation in your document :raised\_hands:

![Citing multiple articles](/files/yVo9MjDI97kKwzxnYIHQ)

There you go, managing citation and document structure have never been easier, happy writing!


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://wiki.medistree.id/tools/authorea.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.