larkumlab
/
Dealing_with_Gin


			
							123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287
							<!DOCTYPE html>
<html lang="" xml:lang="">
<head>

  <meta charset="utf-8" />
  <meta http-equiv="X-UA-Compatible" content="IE=edge" />
  <title>7 Uploading files | dealing with gin</title>
  <meta name="description" content="7 Uploading files | dealing with gin" />
  <meta name="generator" content="bookdown 0.17 and GitBook 2.6.7" />

  <meta property="og:title" content="7 Uploading files | dealing with gin" />
  <meta property="og:type" content="book" />
  
  
  <meta name="twitter:card" content="summary" />
  <meta name="twitter:title" content="7 Uploading files | dealing with gin" />
  
  
  <meta name="viewport" content="width=device-width, initial-scale=1" />
  <meta name="apple-mobile-web-app-capable" content="yes" />
  <meta name="apple-mobile-web-app-status-bar-style" content="black" />
  
  
<link rel="prev" href="downloading-files.html"/>
<link rel="next" href="using-application-made-for-git.html"/>
<script src="libs/jquery-2.2.3/jquery.min.js"></script>
<link href="libs/gitbook-2.6.7/css/style.css" rel="stylesheet" />
<link href="libs/gitbook-2.6.7/css/plugin-table.css" rel="stylesheet" />
<link href="libs/gitbook-2.6.7/css/plugin-bookdown.css" rel="stylesheet" />
<link href="libs/gitbook-2.6.7/css/plugin-highlight.css" rel="stylesheet" />
<link href="libs/gitbook-2.6.7/css/plugin-search.css" rel="stylesheet" />
<link href="libs/gitbook-2.6.7/css/plugin-fontsettings.css" rel="stylesheet" />
<link href="libs/gitbook-2.6.7/css/plugin-clipboard.css" rel="stylesheet" />


</head>

<body>


  <div class="book without-animation with-summary font-size-2 font-family-1" data-basepath=".">

    <div class="book-summary">
      <nav role="navigation">

<ul class="summary">
<li class="chapter" data-level="1" data-path="index.html"><a href="index.html"><i class="fa fa-check"></i><b>1</b> Dealing with Gin</a></li>
<li class="chapter" data-level="2" data-path="play-with-sandbox.html"><a href="play-with-sandbox.html"><i class="fa fa-check"></i><b>2</b> Play with Sandbox</a></li>
<li class="chapter" data-level="3" data-path="cannot-see-a-repository.html"><a href="cannot-see-a-repository.html"><i class="fa fa-check"></i><b>3</b> Cannot see a repository?</a><ul>
<li class="chapter" data-level="3.1" data-path="cannot-see-a-repository.html"><a href="cannot-see-a-repository.html#sign-in-to-gin"><i class="fa fa-check"></i><b>3.1</b> Sign in to Gin</a></li>
<li class="chapter" data-level="3.2" data-path="cannot-see-a-repository.html"><a href="cannot-see-a-repository.html#check-that-the-repository-exists"><i class="fa fa-check"></i><b>3.2</b> Check that the repository exists</a></li>
<li class="chapter" data-level="3.3" data-path="cannot-see-a-repository.html"><a href="cannot-see-a-repository.html#make-sure-you-have-access-to-the-repository"><i class="fa fa-check"></i><b>3.3</b> Make sure you have access to the repository</a></li>
</ul></li>
<li class="chapter" data-level="4" data-path="dashboard-how-to-use.html"><a href="dashboard-how-to-use.html"><i class="fa fa-check"></i><b>4</b> Dashboard: how to use</a><ul>
<li class="chapter" data-level="4.1" data-path="dashboard-how-to-use.html"><a href="dashboard-how-to-use.html#activity"><i class="fa fa-check"></i><b>4.1</b> Activity</a></li>
<li class="chapter" data-level="4.2" data-path="dashboard-how-to-use.html"><a href="dashboard-how-to-use.html#collaborative-repositories"><i class="fa fa-check"></i><b>4.2</b> Collaborative repositories</a></li>
<li class="chapter" data-level="4.3" data-path="dashboard-how-to-use.html"><a href="dashboard-how-to-use.html#private-repositories"><i class="fa fa-check"></i><b>4.3</b> Private repositories</a></li>
</ul></li>
<li class="chapter" data-level="5" data-path="browsing-a-repository.html"><a href="browsing-a-repository.html"><i class="fa fa-check"></i><b>5</b> Browsing a repository</a><ul>
<li class="chapter" data-level="5.1" data-path="browsing-a-repository.html"><a href="browsing-a-repository.html#overview-of-the-repository"><i class="fa fa-check"></i><b>5.1</b> Overview of the repository</a></li>
<li class="chapter" data-level="5.2" data-path="browsing-a-repository.html"><a href="browsing-a-repository.html#browsing-files"><i class="fa fa-check"></i><b>5.2</b> Browsing files</a><ul>
<li class="chapter" data-level="5.2.1" data-path="browsing-a-repository.html"><a href="browsing-a-repository.html#a-small-side-note"><i class="fa fa-check"></i><b>5.2.1</b> A small side note</a></li>
</ul></li>
</ul></li>
<li class="chapter" data-level="6" data-path="downloading-files.html"><a href="downloading-files.html"><i class="fa fa-check"></i><b>6</b> Downloading files</a><ul>
<li class="chapter" data-level="6.1" data-path="downloading-files.html"><a href="downloading-files.html#download-button"><i class="fa fa-check"></i><b>6.1</b> Download button</a></li>
</ul></li>
<li class="chapter" data-level="7" data-path="uploading-files.html"><a href="uploading-files.html"><i class="fa fa-check"></i><b>7</b> Uploading files</a><ul>
<li class="chapter" data-level="7.1" data-path="uploading-files.html"><a href="uploading-files.html#location-of-the-buttons"><i class="fa fa-check"></i><b>7.1</b> Location of the buttons</a></li>
<li class="chapter" data-level="7.2" data-path="uploading-files.html"><a href="uploading-files.html#common-features-for-file-upload"><i class="fa fa-check"></i><b>7.2</b> Common features for file-upload</a><ul>
<li class="chapter" data-level="7.2.1" data-path="uploading-files.html"><a href="uploading-files.html#specifying-the-directory-to-be-uploaded"><i class="fa fa-check"></i><b>7.2.1</b> Specifying the directory to be uploaded</a></li>
<li class="chapter" data-level="7.2.2" data-path="uploading-files.html"><a href="uploading-files.html#committing-new-files"><i class="fa fa-check"></i><b>7.2.2</b> Committing new files</a></li>
</ul></li>
<li class="chapter" data-level="7.3" data-path="uploading-files.html"><a href="uploading-files.html#uploading-a-set-of-files"><i class="fa fa-check"></i><b>7.3</b> Uploading a set of files</a></li>
<li class="chapter" data-level="7.4" data-path="uploading-files.html"><a href="uploading-files.html#create-a-new-text-file"><i class="fa fa-check"></i><b>7.4</b> Create a new (text) file</a></li>
<li class="chapter" data-level="7.5" data-path="uploading-files.html"><a href="uploading-files.html#edit-a-text-file"><i class="fa fa-check"></i><b>7.5</b> Edit a (text) file</a></li>
</ul></li>
<li class="chapter" data-level="8" data-path="using-application-made-for-git.html"><a href="using-application-made-for-git.html"><i class="fa fa-check"></i><b>8</b> Using application made for git</a></li>
<li class="chapter" data-level="9" data-path="using-rstudio-with-gin.html"><a href="using-rstudio-with-gin.html"><i class="fa fa-check"></i><b>9</b> Using Rstudio with GIN</a></li>
</ul>

      </nav>
    </div>

    <div class="book-body">
      <div class="body-inner">
        <div class="book-header" role="navigation">
          <h1>
            <i class="fa fa-circle-o-notch fa-spin"></i><a href="./">dealing with gin</a>
          </h1>
        </div>

        <div class="page-wrapper" tabindex="-1" role="main">
          <div class="page-inner">

            <section class="normal" id="section-">
<div id="uploading-files" class="section level1">
<h1><span class="header-section-number">7</span> Uploading files</h1>
<p>The Gin web-interface allows you to:</p>
<ul>
<li><a href="uploading-files.html#create-a-new-text-file">create</a> a new text-based file,</li>
<li><a href="uploading-files.html#edit-a-text-file">edit</a> a text-based file, or</li>
<li><a href="uploading-files.html#uploading-a-set-of-files">upload</a> a new set of files.</li>
</ul>
<p>All of the above procedures share some features in common:</p>
<ul>
<li>You can start both of the procedures easily by <a href="uploading-files.html#location-of-the-buttons">a click of a button</a>.</li>
<li>You can <a href="uploading-files.html#specifying-the-directory-to-be-uploaded">specify the sub-directory in the repository</a> for the file(s) to be uploaded.</li>
<li>You can <a href="uploading-files.html#committing-new-files">specify the commit options</a>.</li>
</ul>
<div id="location-of-the-buttons" class="section level2">
<h2><span class="header-section-number">7.1</span> Location of the buttons</h2>
<p>When the web interface shows a list of files in a repository, you can see blue buttons in the middle, above the file list.</p>
<blockquote>
<p>Note that, if you don’t have the “write” permission to the repository, these buttons will not appear. If you still want to create or upload files, contact the person responsible for the repository to <a href="collaboration.md">add you as a Collaborator</a>.</p>
</blockquote>
<div class="figure">
<img src="images/upload-actions.png" alt="Where you can find the buttons for file-creation / upload" />
<p class="caption">Where you can find the buttons for file-creation / upload</p>
</div>
<p>There, you have two types of buttons:</p>
<ul>
<li><strong><a href="uploading-files.html#uploading-a-set-of-files">“Upload file” button</a></strong>: used to upload a set of files.</li>
<li><strong><a href="#create-new-files">“New file” button</a></strong>: used to create a new file in the repository.</li>
</ul>
<div class="figure">
<img src="images/upload-actions-buttons.png" alt="Two buttons for new files" />
<p class="caption">Two buttons for new files</p>
</div>
</div>
<div id="common-features-for-file-upload" class="section level2">
<h2><span class="header-section-number">7.2</span> Common features for file-upload</h2>
<p>No matter which button you use, there are some features shared in common.</p>
<div id="specifying-the-directory-to-be-uploaded" class="section level3">
<h3><span class="header-section-number">7.2.1</span> Specifying the directory to be uploaded</h3>
<p>On top of the view, an empty text field will show up:</p>
<div class="figure">
<img src="images/directory-selector-empty.png" alt="Directory selector" />
<p class="caption">Directory selector</p>
</div>
<p>This is for specifying the directory to upload the file(s).</p>
<p>For instance:</p>
<ul>
<li>Enter the name of the subdirectory (within the repository) in this field:</li>
</ul>
<div class="figure">
<img src="images/directory-selector-subdir.png" alt="A subdirectory is specified" />
<p class="caption">A subdirectory is specified</p>
</div>
<ul>
<li>Gin will automatically create a new directory with the given name (in case it does not exist) as you <a href="uploading-files.html#committing-new-files">commit uploads (see the section below)</a>:</li>
</ul>
<div class="figure">
<img src="images/created-subdir.png" alt="Created subdirectory" />
<p class="caption">Created subdirectory</p>
</div>
<ul>
<li>Inside the subdirectory, you will find the uploaded file(s):</li>
</ul>
<div class="figure">
<img src="images/subdir-content.png" alt="The uploaded file in the sub-directory" />
<p class="caption">The uploaded file in the sub-directory</p>
</div>
<p>You can also specify the <em>path</em> to the directory of interest, by connecting a hierarchy of directories by a <code>/</code> (slash):</p>
<p>TODO</p>
</div>
<div id="committing-new-files" class="section level3">
<h3><span class="header-section-number">7.2.2</span> Committing new files</h3>
<p>TODO</p>
</div>
</div>
<div id="uploading-a-set-of-files" class="section level2">
<h2><span class="header-section-number">7.3</span> Uploading a set of files</h2>
<p>When you click on the “Upload file” button, the file upload view will appear:</p>
<div class="figure">
<img src="images/upload-view.png" alt="File-upload view" />
<p class="caption">File-upload view</p>
</div>
<p>The dotted region in the middle of the page is the <em>upload area</em>:</p>
<div class="figure">
<img src="images/upload-view-upload-area.png" alt="The upload area" />
<p class="caption">The upload area</p>
</div>
<p>You can add the files to be uploaded by either:</p>
<ul>
<li><strong>Clicking on the area</strong>: the file chooser dialog will appear so that you can select files from it.</li>
<li><strong>Drag and drop</strong> individual files or a directory containing a set of files. In the latter case, you can upload the whole directory structure easily.</li>
</ul>
<p>In either case, the upload process will start immediately, and you will see the progress on the area:</p>
<div class="figure">
<img src="images/upload-progress.png" alt="Progress of upload" />
<p class="caption">Progress of upload</p>
</div>
<p>You can specify the directory to be uploaded from the <a href="uploading-files.html#specifying-the-directory-to-be-uploaded">directory selector (see the section above)</a>.</p>
<p>After completion of the upload processes for all files, you can proceed to finish the <a href="uploading-files.html#committing-new-files">commit process (see the section above)</a>.</p>
<blockquote>
<p>Note, by using this upload view, you can only upload 100 files at once, with each file being less than 10 GB in size. If you want to upload more files at once, or upload larger files, you will have to use the command-line interface or WinGIN.</p>
</blockquote>
</div>
<div id="create-a-new-text-file" class="section level2">
<h2><span class="header-section-number">7.4</span> Create a new (text) file</h2>
<p>TODO</p>
</div>
<div id="edit-a-text-file" class="section level2">
<h2><span class="header-section-number">7.5</span> Edit a (text) file</h2>
<p>TODO</p>

</div>
</div>
            </section>

          </div>
        </div>
      </div>
<a href="downloading-files.html" class="navigation navigation-prev " aria-label="Previous page"><i class="fa fa-angle-left"></i></a>
<a href="using-application-made-for-git.html" class="navigation navigation-next " aria-label="Next page"><i class="fa fa-angle-right"></i></a>
    </div>
  </div>
<script src="libs/gitbook-2.6.7/js/app.min.js"></script>
<script src="libs/gitbook-2.6.7/js/lunr.js"></script>
<script src="libs/gitbook-2.6.7/js/clipboard.min.js"></script>
<script src="libs/gitbook-2.6.7/js/plugin-search.js"></script>
<script src="libs/gitbook-2.6.7/js/plugin-sharing.js"></script>
<script src="libs/gitbook-2.6.7/js/plugin-fontsettings.js"></script>
<script src="libs/gitbook-2.6.7/js/plugin-bookdown.js"></script>
<script src="libs/gitbook-2.6.7/js/jquery.highlight.js"></script>
<script src="libs/gitbook-2.6.7/js/plugin-clipboard.js"></script>
<script>
gitbook.require(["gitbook"], function(gitbook) {
gitbook.start({
"sharing": {
"github": false,
"facebook": true,
"twitter": true,
"linkedin": false,
"weibo": false,
"instapaper": false,
"vk": false,
"all": ["facebook", "twitter", "linkedin", "weibo", "instapaper"]
},
"fontsettings": {
"theme": "white",
"family": "sans",
"size": 2
},
"edit": {
"link": null,
"text": null
},
"history": {
"link": null,
"text": null
},
"view": {
"link": null,
"text": null
},
"download": null,
"toc": {
"collapse": "subsection"
}
});
});
</script>

</body>

</html>