# Manuscript

There are different ways to add a manuscript. :

* [**Upload via manuscript URL**](#add-an-existing-manuscript-via-url)&#x20;
* [**Upload via file format**](#add-a-manuscript-via-pdf-upload) **(pdf)**
* [**\[TBD\] Create in-situ**](#tbd-create-and-edit-a-manuscript-in-situ)

You can add manuscripts through [Node Drive Panel](/general-user-overview/node-workspace/node-drive-panel.md) for the first two basic upload methods. Extra information on how they relate to manuscripts is available below.&#x20;

In development is the ability to create and [**edit manuscripts**](#tbd-create-and-edit-a-manuscript-in-situ) within a text editor in Nodes.&#x20;

{% hint style="info" %}
The best way to ensure the discoverability of your Node is to include a standard academic manuscript that will be indexed by academic databases like Google Scholar. To ensure your manuscript (and Node) is indexed, make sure your manuscript meets the following requirements:

* The full text of your manuscript needs to be a PDF file that ends with ".pdf",
* The title of the manuscript appears in a large font on top of the first page,
* The authors of the manuscript are listed right below the title on a separate line,&#x20;
* There's a bibliography section titled "References," "Bibliography," or similar at the end.

Google Scholar and other academic databases will then ensure that your Node is findable by others and track citations of your Nodes.
{% endhint %}

Manuscripts can be added either [via the URL](#uploading-an-existing-manuscript) to your PDF or by [uploading it as a PDF file.](#add-a-manuscript-via-pdf-upload)&#x20;

## Add an existing manuscript via URL

You can add a manuscript that is publicly available elsewhere via its URL. Just copy/paste the link that resolves to your web PDF into the URL field, as found in the [Node Drive Panel](/general-user-overview/node-workspace/node-drive-panel.md).&#x20;

You can see basic instructions for URL uploads [here](/create-and-publish/create-a-node/add-components.md#adding-a-url). *Make sure that the URL ends in '.pdf' for it to be properly imported as a manuscript.*

The video below demonstrates how to import a .pdf file through a web link.&#x20;

<figure><img src="/files/pH7T13s2HfhqDE9SMaZu" alt=""><figcaption><p>Importing a manuscript/document from a .pdf URL</p></figcaption></figure>

{% hint style="warning" %}
Before you add a manuscript, make sure its licensing allows you to publish this work elsewhere to avoid inadvertent violations of copyright.&#x20;

[Find out more about licenses here.](broken://pages/HzZRClUmfqbIOFjUdFKv)
{% endhint %}

{% hint style="info" %}
In case you're wondering why we don't offer the option to upload a manuscript via its DOI: That's because of [inconsistent resolution](https://arxiv.org/abs/2004.03011) behaviour. The only way to consistently resolve your DOIs to your manuscript via SciHub, and that's not legal for us to do.&#x20;
{% endhint %}

## Add a manuscript via PDF upload

If you want to upload a manuscript without a URL, you can simply upload the PDF file from your local files. See file upload options:

* [Add Components](/create-and-publish/create-a-node/add-components.md#drag-and-drop)
* [Add Components](/create-and-publish/create-a-node/add-components.md#upload-from-desktop)

{% hint style="info" %}
In case you made a mistake, [here's how to delete a component](/create-and-publish/publish/update-your-node/delete-components-after-publication.md).
{% endhint %}

## \[TBD] Create & edit a manuscript in situ

**In progress:** We are currently creating an in-app text editing programme, so you can create or edit your manuscripts. Either from scratch or from an uploaded file.&#x20;


---

# 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://docs.desci.com/create-and-publish/create-a-node/add-components/manuscript.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.
