Updated welcome document
This commit is contained in:
parent
5ee7b51520
commit
8ccbe7cae4
@ -1,14 +1,14 @@
|
|||||||
Welcome to StackEdit! {#welcome}
|
Welcome to StackEdit!
|
||||||
====================
|
===================
|
||||||
|
|
||||||
|
|
||||||
Hello, I am your first Markdown document within **StackEdit**[^stackedit]. Don't delete me, I can be helpful. I can be recovered anyway in the `Utils` tab of the <i class="icon-cog"></i> `Settings` dialog.
|
Hello, I'm your first Markdown document in **StackEdit**[^stackedit]. Don't delete me, I can be helpful. I can be recovered anyway in the **Utils** tab of the <i class="icon-cog"></i> **Settings** dialog.
|
||||||
|
|
||||||
----------
|
----------
|
||||||
|
|
||||||
|
|
||||||
Documents
|
Documents
|
||||||
--------------
|
-------------
|
||||||
|
|
||||||
**StackEdit** stores your documents in your browser, which means all your documents are automatically saved locally and are accessible **offline!**
|
**StackEdit** stores your documents in your browser, which means all your documents are automatically saved locally and are accessible **offline!**
|
||||||
|
|
||||||
@ -16,15 +16,15 @@ Documents
|
|||||||
|
|
||||||
> - StackEdit is accessible offline after the application has been loaded for the first time.
|
> - StackEdit is accessible offline after the application has been loaded for the first time.
|
||||||
> - Your local documents are not shared between different browsers or computers.
|
> - Your local documents are not shared between different browsers or computers.
|
||||||
> - Clearing your browser's data may **delete all your local documents!** Make sure your documents are backed up using **Google Drive** or **Dropbox** synchronization (see [<i class="icon-refresh"></i> Synchronization](#synchronization) section).
|
> - Clearing your browser's data may **delete all your local documents!** Make sure your documents are synchronized with your **Google Drive** or your **Dropbox** account (check out the [<i class="icon-refresh"></i> Synchronization](#synchronization) section).
|
||||||
|
|
||||||
#### <i class="icon-file"></i> Create a document
|
#### <i class="icon-file"></i> Create a document
|
||||||
|
|
||||||
The document panel is accessible using <i class="icon-folder-open"></i> button in the navigation bar. You can create a new document by clicking the <i class="icon-file"></i> `New document` sub-menu in the document panel.
|
The document panel is accessible using <i class="icon-folder-open"></i> button in the navigation bar. You can create a new document by clicking <i class="icon-file"></i> **New document** in the document panel.
|
||||||
|
|
||||||
#### <i class="icon-folder-open"></i> Switch to another document
|
#### <i class="icon-folder-open"></i> Switch to another document
|
||||||
|
|
||||||
All your local documents are listed in the document panel. You can switch from one to another by clicking a document in the document panel or you can also use <kbd>Ctrl+[</kbd> and <kbd>Ctrl+]</kbd> to toggle documents by most recently used.
|
All your local documents are listed in the document panel. You can switch from one to another by clicking a document in the list or you can toggle documents using <kbd>Ctrl+[</kbd> and <kbd>Ctrl+]</kbd>.
|
||||||
|
|
||||||
#### <i class="icon-pencil"></i> Rename a document
|
#### <i class="icon-pencil"></i> Rename a document
|
||||||
|
|
||||||
@ -32,20 +32,20 @@ You can rename the current document by clicking the document title in the naviga
|
|||||||
|
|
||||||
#### <i class="icon-trash"></i> Delete a document
|
#### <i class="icon-trash"></i> Delete a document
|
||||||
|
|
||||||
You can delete the current document by clicking the <i class="icon-trash"></i> `Delete document` sub-menu in the document panel.
|
You can delete the current document by clicking <i class="icon-trash"></i> **Delete document** in the document panel.
|
||||||
|
|
||||||
#### <i class="icon-hdd"></i> Export a document
|
#### <i class="icon-hdd"></i> Export a document
|
||||||
|
|
||||||
You can save the current document to a file using the <i class="icon-hdd"></i> `Export to disk` sub-menu from the <i class="icon-provider-stackedit"></i> menu panel.
|
You can save the current document to a file by clicking <i class="icon-hdd"></i> **Export to disk** from the <i class="icon-provider-stackedit"></i> menu panel.
|
||||||
|
|
||||||
> **Tip:** See [<i class="icon-upload"></i> Publish a document](#publish-a-document) section for a description of the different output formats.
|
> **Tip:** Check out the [<i class="icon-upload"></i> Publish a document](#publish-a-document) section for a description of the different output formats.
|
||||||
|
|
||||||
|
|
||||||
----------
|
----------
|
||||||
|
|
||||||
|
|
||||||
Synchronization
|
Synchronization
|
||||||
--------------------
|
-------------------
|
||||||
|
|
||||||
**StackEdit** can be combined with <i class="icon-provider-gdrive"></i> **Google Drive** and <i class="icon-provider-dropbox"></i> **Dropbox** to have your documents centralized in the *Cloud*. The synchronization mechanism will take care of uploading your modifications or downloading the latest version of your documents.
|
**StackEdit** can be combined with <i class="icon-provider-gdrive"></i> **Google Drive** and <i class="icon-provider-dropbox"></i> **Dropbox** to have your documents centralized in the *Cloud*. The synchronization mechanism will take care of uploading your modifications or downloading the latest version of your documents.
|
||||||
|
|
||||||
@ -57,15 +57,15 @@ Synchronization
|
|||||||
|
|
||||||
#### <i class="icon-refresh"></i> Open a document
|
#### <i class="icon-refresh"></i> Open a document
|
||||||
|
|
||||||
You can open a document from <i class="icon-provider-gdrive"></i> **Google Drive** or the <i class="icon-provider-dropbox"></i> **Dropbox** by opening the <i class="icon-refresh"></i> `Synchronize` sub-menu and by clicking `Open from...`. Once opened, any modification in your document will be automatically synchronized with the **Google Drive** / **Dropbox** file.
|
You can open a document from <i class="icon-provider-gdrive"></i> **Google Drive** or the <i class="icon-provider-dropbox"></i> **Dropbox** by opening the <i class="icon-refresh"></i> **Synchronize** sub-menu and by clicking **Open from...**. Once opened, any modification in your document will be automatically synchronized with the file in your **Google Drive** / **Dropbox** account.
|
||||||
|
|
||||||
#### <i class="icon-refresh"></i> Save a document
|
#### <i class="icon-refresh"></i> Save a document
|
||||||
|
|
||||||
You can save any document by opening the <i class="icon-refresh"></i> `Synchronize` sub-menu and by clicking `Save on...`. Even if your document is already synchronized with **Google Drive** or **Dropbox**, you can export it to a another location. **StackEdit** can synchronize one document with multiple locations.
|
You can save any document by opening the <i class="icon-refresh"></i> **Synchronize** sub-menu and by clicking **Save on...**. Even if your document is already synchronized with **Google Drive** or **Dropbox**, you can export it to a another location. **StackEdit** can synchronize one document with multiple locations and accounts.
|
||||||
|
|
||||||
#### <i class="icon-refresh"></i> Synchronize a document
|
#### <i class="icon-refresh"></i> Synchronize a document
|
||||||
|
|
||||||
Once your document is linked to a <i class="icon-provider-gdrive"></i> **Google Drive** or a <i class="icon-provider-dropbox"></i> **Dropbox** file, **StackEdit** will periodically (every 3 minutes) synchronize it by downloading/uploading any modification. Any conflict will be detected, and a local copy of your document will be created as a backup if necessary.
|
Once your document is linked to a <i class="icon-provider-gdrive"></i> **Google Drive** or a <i class="icon-provider-dropbox"></i> **Dropbox** file, **StackEdit** will periodically (every 3 minutes) synchronize it by downloading/uploading any modification. A merge will be performed if necessary and conflicts will be detected.
|
||||||
|
|
||||||
If you just have modified your document and you want to force the synchronization, click the <i class="icon-refresh"></i> button in the navigation bar.
|
If you just have modified your document and you want to force the synchronization, click the <i class="icon-refresh"></i> button in the navigation bar.
|
||||||
|
|
||||||
@ -73,7 +73,7 @@ If you just have modified your document and you want to force the synchronizatio
|
|||||||
|
|
||||||
#### <i class="icon-refresh"></i> Manage document synchronization
|
#### <i class="icon-refresh"></i> Manage document synchronization
|
||||||
|
|
||||||
Since one document can be synchronized with multiple locations, you can list and manage synchronized locations by clicking <i class="icon-refresh"></i> `Manage synchronization` in the <i class="icon-refresh"></i> `Synchronize` sub-menu. This will let you remove synchronization locations that are associated to your document.
|
Since one document can be synchronized with multiple locations, you can list and manage synchronized locations by clicking <i class="icon-refresh"></i> **Manage synchronization** in the <i class="icon-refresh"></i> **Synchronize** sub-menu. This will let you remove synchronization locations that are associated to your document.
|
||||||
|
|
||||||
> **Note:** If you delete the file from **Google Drive** or from **Dropbox**, the document will no longer be synchronized with that location.
|
> **Note:** If you delete the file from **Google Drive** or from **Dropbox**, the document will no longer be synchronized with that location.
|
||||||
|
|
||||||
@ -81,19 +81,19 @@ Since one document can be synchronized with multiple locations, you can list and
|
|||||||
|
|
||||||
|
|
||||||
Publication
|
Publication
|
||||||
--------------
|
-------------
|
||||||
|
|
||||||
Once you are happy with your document, you can publish it on different websites directly from **StackEdit**. As for now, **StackEdit** can publish on **Blogger**, **Dropbox**, **Gist**, **GitHub**, **Google Drive**, **Tumblr**, **WordPress** and on any SSH server.
|
Once you are happy with your document, you can publish it on different websites directly from **StackEdit**. As for now, **StackEdit** can publish on **Blogger**, **Dropbox**, **Gist**, **GitHub**, **Google Drive**, **Tumblr**, **WordPress** and on any SSH server.
|
||||||
|
|
||||||
#### <i class="icon-upload"></i> Publish a document
|
#### <i class="icon-upload"></i> Publish a document
|
||||||
|
|
||||||
You can publish your document by opening the <i class="icon-upload"></i> `Publish` sub-menu and by choosing a website. In the dialog box, you can choose the publication format:
|
You can publish your document by opening the <i class="icon-upload"></i> **Publish** sub-menu and by choosing a website. In the dialog box, you can choose the publication format:
|
||||||
|
|
||||||
- Markdown, to publish the Markdown text on a website that can interpret it (**GitHub** for example),
|
- Markdown, to publish the Markdown text on a website that can interpret it (**GitHub** for instance),
|
||||||
- HTML, to publish the document converted into HTML (on a blog for example),
|
- HTML, to publish the document converted into HTML (on a blog for example),
|
||||||
- Template, to have a full control of the output.
|
- Template, to have a full control of the output.
|
||||||
|
|
||||||
> **Note:** The default template is a simple webpage wrapping your document in HTML format. You can customize it in the `Advanced` tab of the <i class="icon-cog"></i> `Settings` dialog.
|
> **Note:** The default template is a simple webpage wrapping your document in HTML format. You can customize it in the **Advanced** tab of the <i class="icon-cog"></i> **Settings** dialog.
|
||||||
|
|
||||||
#### <i class="icon-upload"></i> Update a publication
|
#### <i class="icon-upload"></i> Update a publication
|
||||||
|
|
||||||
@ -103,9 +103,9 @@ After publishing, **StackEdit** will keep your document linked to that publicati
|
|||||||
|
|
||||||
#### <i class="icon-upload"></i> Manage document publication
|
#### <i class="icon-upload"></i> Manage document publication
|
||||||
|
|
||||||
Since one document can be published on multiple locations, you can list and manage publish locations by clicking <i class="icon-upload"></i> `Manage publication` in the <i class="icon-provider-stackedit"></i> menu. This will let you remove publication locations that are associated to your document.
|
Since one document can be published on multiple locations, you can list and manage publish locations by clicking <i class="icon-upload"></i> **Manage publication** in the <i class="icon-provider-stackedit"></i> menu panel. This will let you remove publication locations that are associated to your document.
|
||||||
|
|
||||||
> **Note:** In some cases, if the file has been removed from the website or the blog, the document will no longer be published on that location.
|
> **Note:** If the file has been removed from the website or the blog, the document will no longer be published on that location.
|
||||||
|
|
||||||
----------
|
----------
|
||||||
|
|
||||||
@ -115,7 +115,7 @@ Markdown Extra
|
|||||||
|
|
||||||
**StackEdit** supports **Markdown Extra**, which extends **Markdown** syntax with some nice features.
|
**StackEdit** supports **Markdown Extra**, which extends **Markdown** syntax with some nice features.
|
||||||
|
|
||||||
> **Tip:** You can disable any **Markdown Extra** feature in the `Extensions` tab of the <i class="icon-cog"></i> `Settings` dialog.
|
> **Tip:** You can disable any **Markdown Extra** feature in the **Extensions** tab of the <i class="icon-cog"></i> **Settings** dialog.
|
||||||
|
|
||||||
> **Note:** You can find more information about **Markdown** syntax [here][2] and **Markdown Extra** extension [here][3].
|
> **Note:** You can find more information about **Markdown** syntax [here][2] and **Markdown Extra** extension [here][3].
|
||||||
|
|
||||||
@ -166,7 +166,7 @@ GitHub's fenced code blocks[^gfm] are also supported with **Prettify** syntax hi
|
|||||||
var bar = 0;
|
var bar = 0;
|
||||||
```
|
```
|
||||||
|
|
||||||
> **Tip:** To use **Highlight.js** instead of **Prettify**, just configure the `Markdown Extra` extension in the <i class="icon-cog"></i> `Settings` dialog.
|
> **Tip:** To use **Highlight.js** instead of **Prettify**, just configure the **Markdown Extra** extension in the <i class="icon-cog"></i> **Settings** dialog.
|
||||||
|
|
||||||
> **Note:** You can find more information:
|
> **Note:** You can find more information:
|
||||||
|
|
||||||
@ -248,7 +248,7 @@ cond(no)->op
|
|||||||
|
|
||||||
[^stackedit]: [StackEdit](https://stackedit.io/) is a full-featured, open-source Markdown editor based on PageDown, the Markdown library used by Stack Overflow and the other Stack Exchange sites.
|
[^stackedit]: [StackEdit](https://stackedit.io/) is a full-featured, open-source Markdown editor based on PageDown, the Markdown library used by Stack Overflow and the other Stack Exchange sites.
|
||||||
|
|
||||||
[^gfm]: **GitHub Flavored Markdown** (GFM) is supported by StackEdit.
|
[^gfm]: **GitHub Flavored Markdown** (GFM) is supported in StackEdit.
|
||||||
|
|
||||||
|
|
||||||
[1]: http://math.stackexchange.com/
|
[1]: http://math.stackexchange.com/
|
||||||
|
Loading…
Reference in New Issue
Block a user