19a8b66cee
Create a full loop of documentation for rclone about, backends overview and individual backend pages. Discussion: https://github.com/rclone/rclone/pull/4774 relates Previously pull was requested, in part, under ref https://github.com/rclone/rclone/pull/4801 Notes: Introduce a tentative draft see-link format the end of sections to try rather than lots of in-para links. Update about.go incl link to list of backends not supporting about. In list of backends not supporting about, include link to about command reference. I appreciate there may be decisions to make going forward about whether command links should be code formatted, and using proper pretty url links, but I have fudged that for now. Update backend pages that do not support about with wording used previously for ftp - it is in passive voice but I can live with it. (my own wording and fault). The note is applied to a limitations section. If one does not already exist it is created (even if there are other limitations with their own sections)
77 lines
3.7 KiB
Markdown
77 lines
3.7 KiB
Markdown
# Docs
|
|
|
|
This directory tree is used to build all the different docs for
|
|
rclone.
|
|
|
|
See the `content` directory for the docs in markdown format.
|
|
|
|
Note that some of the docs are auto generated - these should have a DO
|
|
NOT EDIT marker near the top.
|
|
|
|
Use [hugo](https://github.com/spf13/hugo) to build the website.
|
|
|
|
## Changing the layout
|
|
|
|
If you want to change the layout then the main files to edit are
|
|
|
|
- `layout/index.html` for the front page
|
|
- `chrome/*.html` for the HTML fragments
|
|
- `_default/single.md` for the default template
|
|
- `page/single.md` for the page template
|
|
|
|
Running `make serve` in a terminal give a live preview of the website
|
|
so it is easy to tweak stuff.
|
|
|
|
## What are all these files
|
|
|
|
```
|
|
├── config.json - hugo config file
|
|
├── content - docs and backend docs
|
|
│ ├── _index.md - the front page of rclone.org
|
|
│ ├── commands - auto generated command docs - DO NOT EDIT
|
|
├── i18n
|
|
│ └── en.toml - hugo multilingual config
|
|
├── layouts - how the markdown gets converted into HTML
|
|
│ ├── 404.html - 404 page
|
|
│ ├── chrome - contains parts of the HTML page included elsewhere
|
|
│ │ ├── footer.copyright.html - copyright footer
|
|
│ │ ├── footer.html - footer including scripts
|
|
│ │ ├── header.html - the whole html header
|
|
│ │ ├── header.includes.html - header includes e.g. css files
|
|
│ │ ├── menu.html - left hand side menu
|
|
│ │ ├── meta.html - meta tags for the header
|
|
│ │ └── navbar.html - top navigation bar
|
|
│ ├── _default
|
|
│ │ └── single.html - the default HTML page render
|
|
│ ├── index.html - the index page of the whole site
|
|
│ ├── page
|
|
│ │ └── single.html - the render of all "page" type markdown
|
|
│ ├── partials - bits of HTML to include into layout .html files
|
|
│ │ └── version.html - the current version number
|
|
│ ├── rss.xml - template for the RSS output
|
|
│ ├── section - rendering for sections
|
|
│ │ └── commands.html - rendering for /commands/index.html
|
|
│ ├── shortcodes - shortcodes to call from markdown files
|
|
│ │ ├── cdownload.html - download the "current" version
|
|
│ │ ├── download.html - download a version with the partials/version.html number
|
|
│ │ ├── provider.html - used to make provider list on the front page
|
|
│ │ └── version.html - used to insert the current version number
|
|
│ └── sitemap.xml - sitemap template
|
|
├── public - render of the website
|
|
├── README.md - this file
|
|
├── resources - don't know!
|
|
│ └── _gen
|
|
│ ├── assets
|
|
│ └── images
|
|
└── static - static content for the website
|
|
├── css
|
|
│ ├── bootstrap.css
|
|
│ ├── custom.css - custom css goes here
|
|
│ └── font-awesome.css
|
|
├── img - images used
|
|
├── js
|
|
│ ├── bootstrap.js
|
|
│ ├── custom.js - custom javascript goes here
|
|
│ └── jquery.js
|
|
└── webfonts
|
|
```
|