From a442823bc1d8bc4946749a036a5460ceea456a9b Mon Sep 17 00:00:00 2001 From: Christopher Allan Webber Date: Thu, 14 Nov 2013 14:17:18 -0600 Subject: [PATCH] Documenting the command-line uploading tooling. This commit sponsored by Libby Reinish. Thank you! :) --- docs/source/index.rst | 1 + docs/source/siteadmin/commandline-upload.rst | 41 ++++++++++++++++++++ 2 files changed, 42 insertions(+) create mode 100644 docs/source/siteadmin/commandline-upload.rst diff --git a/docs/source/index.rst b/docs/source/index.rst index 75a5b66e..3ead6136 100644 --- a/docs/source/index.rst +++ b/docs/source/index.rst @@ -44,6 +44,7 @@ MediaGoblin website. It is written for site administrators. siteadmin/relnotes siteadmin/theming siteadmin/plugins + siteadmin/commandline-upload .. _core-plugin-section: diff --git a/docs/source/siteadmin/commandline-upload.rst b/docs/source/siteadmin/commandline-upload.rst new file mode 100644 index 00000000..be19df58 --- /dev/null +++ b/docs/source/siteadmin/commandline-upload.rst @@ -0,0 +1,41 @@ +.. MediaGoblin Documentation + + Written in 2011, 2012 by MediaGoblin contributors + + To the extent possible under law, the author(s) have dedicated all + copyright and related and neighboring rights to this software to + the public domain worldwide. This software is distributed without + any warranty. + + You should have received a copy of the CC0 Public Domain + Dedication along with this software. If not, see + . + +====================== +Command-line uploading +====================== + +Want to submit media via the command line? It's fairly easy to do:: + + ./bin/gmg addmedia username your_media.jpg + +This will submit the file "your_media.jpg" to be a media entry +associated with the user "username". + +You can get help on all the available options by running:: + + ./bin/gmg addmedia --help + +Here's a longer example that makes use of more options:: + + ./bin/gmg addmedia aveyah awesome_spaceship.png \ + --title "My awesome spaceship" \ + --description "Flying my awesome spaceship, since I'm an awesome pilot" \ + --license "http://creativecommons.org/licenses/by-sa/3.0/" \ + --tags "spaceships, pilots, awesome" \ + --slug "awesome-spaceship" + +You can also pass in the `--celery` option if you would prefer that +your media be passed over to celery to be processed rather than be +processed immediately. + -- 2.25.1