WebDAV Setup

Contact

Home > Started > WebDAV | Japanese

WebDAV Setup

Each account is given a folder within the web server run by the Markdown hosting service. The folder is called an account area and you access this area with a WebDAV remote file service to build your own web site.

The URL used to access your account area in the the WebDAV server of the hosting service is:

https://db.ssjava.net/account/

Open File Explorer in Windows or Finder in MacOS, etc. in your local PC, specify the URL above as a remote folder path, type your account name and password you have just registered, and click OK to connect to the WebDAV server.

Here are screen shots taken in Japanese version of Windows 10 that shows an account holder of 'sample' accessing the WebDAV server.

Select [Map Network Drive]:

webdav dialog

Type account name and password:

webdav login

Remote account folder shown:

webdav account folder

Move to the private data folder:

webdav data folder

Account Area

Let me explain the structure of the account area (where account name is guest):

hosting folders

The highest, top level folder of the entire hosting site is at / and can be accessed with a URL shown to the right of /. This area holds the standard pre-installed CSS stylesheet (/pandoc-gfm.css) among other files.

The second level folder, in this case /guest, is called 'account's public area'. This area holds your static web resources, such as HTML files and images. A public user has a read-only access to resources in this area using a URL shown to the right of /guest. The account holder has both read and write access to this area through WebDAV and freely place files, edit and elete them.

The third or bottom level folder, in this case /guest/data is called 'account's private area'. This area holds Markdown source files such as fruit.md and a database file called guest.db A public user has no access to this area. Only the account holder can access this private area through WebDAV and the holder can read and write files in this area.

Here are some hosting service-specific rules about naming and placing files in the account area:

Markdown File Name Convensions

Markdown source is placed under account's private area. From outside, this file is accessed via virtual URL into the public area instead of its real path. The hosting service checks the extension in the URL and determines what kind of conversion it will perform on it.

Example:
https://db.ssjava.net/guest/fruit.mdmp -> /guest/data/fruit.md

A filename of a real Markdown file placed in the private area is:

prefix - name - suffix . md

A typical Markdown file name is simple and it takes the form: name.md such as howto.md or fruit.md.

For database table editing pages, name is the name of a table the page will work on.

The extension of the Markdown file is always md regardless how it is handled. An extension of a virtual URL that points to the Markdown file from outside can vary and it determines how the Markdown source is converted.

Extension Purpose Remark
md Plain Markdown page
mdp Markdown page with PREPRO extension syntax such as Selector and Styler MD + Prepro
mdm Markdown page with Live Data Embedder macros MD + Macro
mdmp Markdown page both with PREPRO syntax and Embedder macros MD + Macro + Prepro

Use md if your page is written in plain Markdown. Use mdmp if you want all the hosting features or you are not sure which to use. It is efficient to specify mdp if you use only the extension syntax, or mdm if you only use the database.

The prefix is optional and if exists, it can either be priv or tckt. The priv prefix allows you to limit access to the page only to you, account holder. No other person can access the page. The tckt prefix requires a visitor to get a ticket prior to access the page. The ticket here is the same kind of thing you have used for account registration. Without either prefix, no access restriction is applied to the table-editing page.

Note that characters used to form a table name can be an alphabet, number or underscores (_). Hyphens are used to separate a prefix, tablename and suffix.

You can attach suffix freely but it in mainly used to distinguish multiple table-editing pages for a single database table.

If you split an automatically-generated table-editing page into two pages for listing and entry, for example, name them like delivery-list.mdmp and delivery-entry.mdmp.

Examples of Markdown file names:

Examples of URLs that point to the above files:

Presenting URL

The URL of your page can be accessed only if you tell it to someone or make it public on your blog page or through SNS. No one knows your page unless you let them do. Therefore, you can share your page either among a closed group of people or open to public.

However privacy is not absolute. A brute-force attack may reveal your page. Avoid making critical and privacy information available to public.

There are some ways to make the URL of your table editing page known to public or target customers.

Presented by Kobu.Com.

Written 2020-Oct-14

Contact