Skip to content

Commit 532479d

Browse files
committed
auto: Update website
1 parent 025d285 commit 532479d

12 files changed

Lines changed: 75 additions & 39 deletions

File tree

404.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@
1515

1616

1717
<link rel="icon" href="/assets/images/favicon.png">
18-
<meta name="generator" content="mkdocs-1.5.1, mkdocs-material-9.1.21">
18+
<meta name="generator" content="mkdocs-1.5.2, mkdocs-material-9.1.21">
1919

2020

2121

browse/index.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@
2121
<link rel="next" href="../usage/archive/">
2222

2323
<link rel="icon" href="../assets/images/favicon.png">
24-
<meta name="generator" content="mkdocs-1.5.1, mkdocs-material-9.1.21">
24+
<meta name="generator" content="mkdocs-1.5.2, mkdocs-material-9.1.21">
2525

2626

2727

contributing/guidelines/index.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@
2121
<link rel="next" href="../naming/">
2222

2323
<link rel="icon" href="../../assets/images/favicon.png">
24-
<meta name="generator" content="mkdocs-1.5.1, mkdocs-material-9.1.21">
24+
<meta name="generator" content="mkdocs-1.5.2, mkdocs-material-9.1.21">
2525

2626

2727

contributing/naming/index.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@
2121
<link rel="next" href="../submission/">
2222

2323
<link rel="icon" href="../../assets/images/favicon.png">
24-
<meta name="generator" content="mkdocs-1.5.1, mkdocs-material-9.1.21">
24+
<meta name="generator" content="mkdocs-1.5.2, mkdocs-material-9.1.21">
2525

2626

2727

contributing/submission/index.html

Lines changed: 58 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@
1919

2020

2121
<link rel="icon" href="../../assets/images/favicon.png">
22-
<meta name="generator" content="mkdocs-1.5.1, mkdocs-material-9.1.21">
22+
<meta name="generator" content="mkdocs-1.5.2, mkdocs-material-9.1.21">
2323

2424

2525

@@ -435,15 +435,29 @@
435435
</li>
436436

437437
<li class="md-nav__item">
438-
<a href="#step-2-create-a-new-public-project-at-osfio" class="md-nav__link">
439-
Step 2: Create a new public project at osf.io
438+
<a href="#step-2-install-the-templateflow-manager" class="md-nav__link">
439+
Step 2: Install the TemplateFlow Manager
440440
</a>
441441

442442
</li>
443443

444444
<li class="md-nav__item">
445-
<a href="#step-3-install-the-templateflow-manager-and-tfmgr-add-your-template" class="md-nav__link">
446-
Step 3: Install the TemplateFlow Manager and tfmgr add your template
445+
<a href="#step-3-prepare-your-credentials-for-authentication" class="md-nav__link">
446+
Step 3: Prepare your credentials for authentication
447+
</a>
448+
449+
</li>
450+
451+
<li class="md-nav__item">
452+
<a href="#step-4-add-your-template-with-tfmgr-add" class="md-nav__link">
453+
Step 4: Add your template with tfmgr add
454+
</a>
455+
456+
</li>
457+
458+
<li class="md-nav__item">
459+
<a href="#finished-the-peer-review-process-is-now-initiated" class="md-nav__link">
460+
Finished: The peer-review process is now initiated
447461
</a>
448462

449463
</li>
@@ -509,15 +523,29 @@
509523
</li>
510524

511525
<li class="md-nav__item">
512-
<a href="#step-2-create-a-new-public-project-at-osfio" class="md-nav__link">
513-
Step 2: Create a new public project at osf.io
526+
<a href="#step-2-install-the-templateflow-manager" class="md-nav__link">
527+
Step 2: Install the TemplateFlow Manager
528+
</a>
529+
530+
</li>
531+
532+
<li class="md-nav__item">
533+
<a href="#step-3-prepare-your-credentials-for-authentication" class="md-nav__link">
534+
Step 3: Prepare your credentials for authentication
514535
</a>
515536

516537
</li>
517538

518539
<li class="md-nav__item">
519-
<a href="#step-3-install-the-templateflow-manager-and-tfmgr-add-your-template" class="md-nav__link">
520-
Step 3: Install the TemplateFlow Manager and tfmgr add your template
540+
<a href="#step-4-add-your-template-with-tfmgr-add" class="md-nav__link">
541+
Step 4: Add your template with tfmgr add
542+
</a>
543+
544+
</li>
545+
546+
<li class="md-nav__item">
547+
<a href="#finished-the-peer-review-process-is-now-initiated" class="md-nav__link">
548+
Finished: The peer-review process is now initiated
521549
</a>
522550

523551
</li>
@@ -574,11 +602,7 @@ <h2 id="step-1-organize-your-template-tree">Step 1: Organize your template tree<
574602
<p class="admonition-title">Examples</p>
575603
<p>Please check the formatting of existing templates in the <a href="../../browse/">Archive browser</a></p>
576604
</div>
577-
<h2 id="step-2-create-a-new-public-project-at-osfio">Step 2: Create a new public project at osf.io<a class="headerlink" href="#step-2-create-a-new-public-project-at-osfio" title="Permanent link">&para;</a></h2>
578-
<p>Head to <a href="https://osf.io/dashboard">your OSF home</a> and create a new project.
579-
Make sure you <strong>make your project public</strong> and write down the project identifier from the URL.</p>
580-
<p><img alt="Screenshot" src="../../assets/osf-project-creation.gif" /></p>
581-
<h2 id="step-3-install-the-templateflow-manager-and-tfmgr-add-your-template">Step 3: Install the TemplateFlow Manager and <code>tfmgr add</code> your template<a class="headerlink" href="#step-3-install-the-templateflow-manager-and-tfmgr-add-your-template" title="Permanent link">&para;</a></h2>
605+
<h2 id="step-2-install-the-templateflow-manager">Step 2: Install the <em>TemplateFlow Manager</em><a class="headerlink" href="#step-2-install-the-templateflow-manager" title="Permanent link">&para;</a></h2>
582606
<p>Installing the manager is as easy as:</p>
583607
<div class="codehilite"><pre><span></span><code>pip<span class="w"> </span>install<span class="w"> </span>git+https://github.com/templateflow/python-manager@master
584608
</code></pre></div>
@@ -588,17 +612,29 @@ <h2 id="step-3-install-the-templateflow-manager-and-tfmgr-add-your-template">Ste
588612
TF<span class="w"> </span>Archive<span class="w"> </span>manager<span class="w"> </span><span class="m">20</span>.0.0
589613
</code></pre></div>
590614

591-
<p>Finally, set up your OSF and GitHub authorization details and call <code>add</code>.
592-
It is fundamental to copy here the OSF project ID from step 2.</p>
593-
<div class="codehilite"><pre><span></span><code>$<span class="w"> </span><span class="nb">export</span><span class="w"> </span><span class="nv">OSF_USERNAME</span><span class="o">=</span><span class="s1">&#39;some@email.com&#39;</span>
594-
$<span class="w"> </span><span class="nb">export</span><span class="w"> </span><span class="nv">OSF_PASSWORD</span><span class="o">=</span><span class="s1">&#39;****&#39;</span>
595-
$<span class="w"> </span><span class="nb">export</span><span class="w"> </span><span class="nv">GITHUB_USER</span><span class="o">=</span><span class="s1">&#39;oesteban&#39;</span>
596-
$<span class="w"> </span><span class="nb">export</span><span class="w"> </span><span class="nv">GITHUB_PASSWORD</span><span class="o">=</span><span class="s1">&#39;****&#39;</span><span class="w"> </span><span class="c1"># or personal access token</span>
615+
<h2 id="step-3-prepare-your-credentials-for-authentication">Step 3: Prepare your credentials for authentication<a class="headerlink" href="#step-3-prepare-your-credentials-for-authentication" title="Permanent link">&para;</a></h2>
616+
<p><strong>On OSF.io</strong>: First, generate a personal authentication token (PAT) to authenticate your username and be able to upload data to OSF.
617+
Good guidelines <a href="https://mjaquiery.github.io/jspsych-born-open-data/osf-pat/index.html">on how to create your PAT on OSF are given here</a>.</p>
618+
<p><strong>On GitHub</strong>: Then, you also want to generate a PAT to authenticate against GitHub.
619+
If you are unsure of how to properly create one, please follow the <a href="https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens">official guidelines</a>, in particular, it is likely easier to avoid permissions problems if you take the <a href="https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens#creating-a-personal-access-token-classic">classic tokens route</a>.</p>
620+
<div class="admonition critical">
621+
<p class="admonition-title">Make sure you store both tokens safely and that you will be able to retrieve them later</p>
622+
</div>
623+
<p><strong>At this point, you can set up your credentials</strong></p>
624+
<div class="codehilite"><pre><span></span><code>$<span class="w"> </span><span class="nb">export</span><span class="w"> </span><span class="nv">OSF_TOKEN</span><span class="o">=</span><span class="s1">&#39;&lt;copy and paste your OSF PAT here&gt;&#39;</span>
625+
$<span class="w"> </span><span class="nb">export</span><span class="w"> </span><span class="nv">GITHUB_USER</span><span class="o">=</span><span class="s1">&#39;&lt;your GitHub handle&gt;&#39;</span><span class="w"> </span><span class="c1"># For instance, &#39;oesteban&#39;</span>
626+
$<span class="w"> </span><span class="nb">export</span><span class="w"> </span><span class="nv">GITHUB_TOKEN</span><span class="o">=</span><span class="s1">&#39;&lt;copy and paste your GitHub PAT here&gt;&#39;</span>
627+
</code></pre></div>
597628

598-
<span class="c1"># Assuming the template is at the current directory, under tpl-Name/</span>
599-
$<span class="w"> </span>tfmgr<span class="w"> </span>add<span class="w"> </span>tpl-Name<span class="w"> </span>--osf-project<span class="w"> </span><span class="s1">&#39;&lt;project_id&gt;&#39;</span>
629+
<h2 id="step-4-add-your-template-with-tfmgr-add">Step 4: Add your template with <code>tfmgr add</code><a class="headerlink" href="#step-4-add-your-template-with-tfmgr-add" title="Permanent link">&para;</a></h2>
630+
<div class="codehilite"><pre><span></span><code><span class="c1"># Assuming the template is at the current directory, under tpl-Name/</span>
631+
$<span class="w"> </span>tfmgr<span class="w"> </span>add<span class="w"> </span>tpl-Name<span class="err">&#39;</span>
600632
</code></pre></div>
601633

634+
<h2 id="finished-the-peer-review-process-is-now-initiated">Finished: The peer-review process is now initiated<a class="headerlink" href="#finished-the-peer-review-process-is-now-initiated" title="Permanent link">&para;</a></h2>
635+
<p>Once <code>tfmgr add</code> has concluded successfully, you'll be provided with a URL that points to a newly created PR against the templateflow superdataset.
636+
That means your PR will now be listed at the <a href="https://github.com/templateflow/templateflow/pulls"><code>templateflow/templateflow</code> repo</a>.
637+
Now, the <a href="https://github.com/orgs/templateflow/teams/maintainers"><em>TemplateFlow</em> maintainers</a> will carry out <em>editorial management</em> of your proposed template and have it peer-reviewed before it is finally <em>merged</em> into <em>TemplateFlow</em>.</p>
602638
<h2 id="wrapping-up">Wrapping up<a class="headerlink" href="#wrapping-up" title="Permanent link">&para;</a></h2>
603639
<p>This screencast summarizes the three-step process above:</p>
604640
<script id="asciicast-331256" src="https://asciinema.org/a/331256.js" async data-autoplay="true" data-speed="4" data-theme="tango"></script>

index.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@
1919
<link rel="next" href="browse/">
2020

2121
<link rel="icon" href="assets/images/favicon.png">
22-
<meta name="generator" content="mkdocs-1.5.1, mkdocs-material-9.1.21">
22+
<meta name="generator" content="mkdocs-1.5.2, mkdocs-material-9.1.21">
2323

2424

2525

search/search_index.json

Lines changed: 1 addition & 1 deletion
Large diffs are not rendered by default.

sitemap.xml

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -2,42 +2,42 @@
22
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
33
<url>
44
<loc>https://www.templateflow.org/</loc>
5-
<lastmod>2023-08-02</lastmod>
5+
<lastmod>2023-08-03</lastmod>
66
<changefreq>daily</changefreq>
77
</url>
88
<url>
99
<loc>https://www.templateflow.org/browse/</loc>
10-
<lastmod>2023-08-02</lastmod>
10+
<lastmod>2023-08-03</lastmod>
1111
<changefreq>daily</changefreq>
1212
</url>
1313
<url>
1414
<loc>https://www.templateflow.org/contributing/guidelines/</loc>
15-
<lastmod>2023-08-02</lastmod>
15+
<lastmod>2023-08-03</lastmod>
1616
<changefreq>daily</changefreq>
1717
</url>
1818
<url>
1919
<loc>https://www.templateflow.org/contributing/naming/</loc>
20-
<lastmod>2023-08-02</lastmod>
20+
<lastmod>2023-08-03</lastmod>
2121
<changefreq>daily</changefreq>
2222
</url>
2323
<url>
2424
<loc>https://www.templateflow.org/contributing/submission/</loc>
25-
<lastmod>2023-08-02</lastmod>
25+
<lastmod>2023-08-03</lastmod>
2626
<changefreq>daily</changefreq>
2727
</url>
2828
<url>
2929
<loc>https://www.templateflow.org/usage/archive/</loc>
30-
<lastmod>2023-08-02</lastmod>
30+
<lastmod>2023-08-03</lastmod>
3131
<changefreq>daily</changefreq>
3232
</url>
3333
<url>
3434
<loc>https://www.templateflow.org/usage/citing/</loc>
35-
<lastmod>2023-08-02</lastmod>
35+
<lastmod>2023-08-03</lastmod>
3636
<changefreq>daily</changefreq>
3737
</url>
3838
<url>
3939
<loc>https://www.templateflow.org/usage/client/</loc>
40-
<lastmod>2023-08-02</lastmod>
40+
<lastmod>2023-08-03</lastmod>
4141
<changefreq>daily</changefreq>
4242
</url>
4343
</urlset>

sitemap.xml.gz

1 Byte
Binary file not shown.

usage/archive/index.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@
2121
<link rel="next" href="../client/">
2222

2323
<link rel="icon" href="../../assets/images/favicon.png">
24-
<meta name="generator" content="mkdocs-1.5.1, mkdocs-material-9.1.21">
24+
<meta name="generator" content="mkdocs-1.5.2, mkdocs-material-9.1.21">
2525

2626

2727

0 commit comments

Comments
 (0)