HPCE/gitea-pages
0
0
Fork 0
Code Issues 3 Pull Requests Actions Packages Projects Activity
Files
0630bafb43cc9b996f31220bdd9f09ea6b5f90e4
gitea-pages/merlin6/jupyterhub/jupytext/index.html
Gitea Actions 0630bafb43 Deployed acde833 with MkDocs version: 1.6.1
2026-02-10 11:25:50 +00:00

4591 lines
70 KiB
HTML
Raw Blame History

<!DOCTYPE html><html lang="en" class="no-js"><head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<link rel="canonical" href="https://hpce.pages.psi.ch/merlin6/jupyterhub/jupytext/">
<link rel="prev" href="../jupyter-examples/">
<link rel="next" href="../jupyter-extensions/">
<link rel="icon" href="../../../images/favicon.ico">
<meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.7.0">
<title>Jupytext - efficient editing - HPCE User Documentation</title>
<link rel="stylesheet" href="../../../assets/stylesheets/main.618322db.min.css">
<link rel="stylesheet" href="../../../assets/stylesheets/palette.ab4e12ef.min.css">
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&amp;display=fallback">
<style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
<link rel="stylesheet" href="../../../css/custom-nav.css">
<script>__md_scope=new URL("../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
<link href="../../../assets/stylesheets/glightbox.min.css" rel="stylesheet"><script src="../../../assets/javascripts/glightbox.min.js"></script><style id="glightbox-style">
html.glightbox-open { overflow: initial; height: 100%; }
.gslide-title { margin-top: 0px; user-select: text; }
.gslide-desc { color: #666; user-select: text; }
.gslide-image img { background: white; }
.gscrollbar-fixer { padding-right: 15px; }
.gdesc-inner { font-size: 0.75rem; }
body[data-md-color-scheme="slate"] .gdesc-inner { background: var(--md-default-bg-color); }
body[data-md-color-scheme="slate"] .gslide-title { color: var(--md-default-fg-color); }
body[data-md-color-scheme="slate"] .gslide-desc { color: var(--md-default-fg-color); }
</style></head>
<body dir="ltr" data-md-color-scheme="default" data-md-color-primary="indigo" data-md-color-accent="indigo">
<input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
<input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
<label class="md-overlay" for="__drawer"></label>
<div data-md-component="skip">
<a href="#jupytext-efficient-editing" class="md-skip">
Skip to content
</a>
</div>
<div data-md-component="announce">
</div>
<header class="md-header md-header--shadow md-header--lifted" data-md-component="header">
<nav class="md-header__inner md-grid" aria-label="Header">
<a href="../../.." title="HPCE User Documentation" class="md-header__button md-logo" aria-label="HPCE User Documentation" data-md-component="logo">
<img src="../../../images/hpce_logo.png" alt="logo">
</a>
<label class="md-header__button md-icon" for="__drawer">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"></path></svg>
</label>
<div class="md-header__title" data-md-component="header-title">
<div class="md-header__ellipsis">
<div class="md-header__topic">
<span class="md-ellipsis">
HPCE User Documentation
</span>
</div>
<div class="md-header__topic" data-md-component="header-topic">
<span class="md-ellipsis">
Jupytext - efficient editing
</span>
</div>
</div>
</div>
<form class="md-header__option" data-md-component="palette">
<input class="md-option" data-md-color-media="(prefers-color-scheme)" data-md-color-scheme="default" data-md-color-primary="indigo" data-md-color-accent="indigo" aria-label="Switch to light mode" type="radio" name="__palette" id="__palette_0">
<label class="md-header__button md-icon" title="Switch to light mode" for="__palette_1" hidden>
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3.9 12c0-1.71 1.39-3.1 3.1-3.1h4V7H7a5 5 0 0 0-5 5 5 5 0 0 0 5 5h4v-1.9H7c-1.71 0-3.1-1.39-3.1-3.1M8 13h8v-2H8zm9-6h-4v1.9h4c1.71 0 3.1 1.39 3.1 3.1s-1.39 3.1-3.1 3.1h-4V17h4a5 5 0 0 0 5-5 5 5 0 0 0-5-5"></path></svg>
</label>
<input class="md-option" data-md-color-media="(prefers-color-scheme: light)" data-md-color-scheme="default" data-md-color-primary="indigo" data-md-color-accent="indigo" aria-label="Switch to dark mode" type="radio" name="__palette" id="__palette_1">
<label class="md-header__button md-icon" title="Switch to dark mode" for="__palette_2" hidden>
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M17 7H7a5 5 0 0 0-5 5 5 5 0 0 0 5 5h10a5 5 0 0 0 5-5 5 5 0 0 0-5-5m0 8a3 3 0 0 1-3-3 3 3 0 0 1 3-3 3 3 0 0 1 3 3 3 3 0 0 1-3 3"></path></svg>
</label>
<input class="md-option" data-md-color-media="(prefers-color-scheme: dark)" data-md-color-scheme="slate" data-md-color-primary="indigo" data-md-color-accent="indigo" aria-label="Switch to system preference" type="radio" name="__palette" id="__palette_2">
<label class="md-header__button md-icon" title="Switch to system preference" for="__palette_0" hidden>
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M17 7H7a5 5 0 0 0-5 5 5 5 0 0 0 5 5h10a5 5 0 0 0 5-5 5 5 0 0 0-5-5M7 15a3 3 0 0 1-3-3 3 3 0 0 1 3-3 3 3 0 0 1 3 3 3 3 0 0 1-3 3"></path></svg>
</label>
</form>
<script>var palette=__md_get("__palette");if(palette&&palette.color){if("(prefers-color-scheme)"===palette.color.media){var media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']");palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent")}for(var[key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
<label class="md-header__button md-icon" for="__search">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"></path></svg>
</label>
<div class="md-search" data-md-component="search" role="dialog">
<label class="md-search__overlay" for="__search"></label>
<div class="md-search__inner" role="search">
<form class="md-search__form" name="search">
<input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
<label class="md-search__icon md-icon" for="__search">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"></path></svg>
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"></path></svg>
</label>
<nav class="md-search__options" aria-label="Search">
<button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"></path></svg>
</button>
</nav>
</form>
<div class="md-search__output">
<div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
<div class="md-search-result" data-md-component="search-result">
<div class="md-search-result__meta">
Initializing search
</div>
<ol class="md-search-result__list" role="presentation"></ol>
</div>
</div>
</div>
</div>
</div>
<div class="md-header__source">
<a href="https://gitea.psi.ch/hpce/gitea-pages" title="Go to repository" class="md-source" data-md-component="source">
<div class="md-source__icon md-icon">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M439.6 236.1 244 40.5c-5.4-5.5-12.8-8.5-20.4-8.5s-15 3-20.4 8.4L162.5 81l51.5 51.5c27.1-9.1 52.7 16.8 43.4 43.7l49.7 49.7c34.2-11.8 61.2 31 35.5 56.7-26.5 26.5-70.2-2.9-56-37.3L240.3 199v121.9c25.3 12.5 22.3 41.8 9.1 55-6.4 6.4-15.2 10.1-24.3 10.1s-17.8-3.6-24.3-10.1c-17.6-17.6-11.1-46.9 11.2-56v-123c-20.8-8.5-24.6-30.7-18.6-45L142.6 101 8.5 235.1C3 240.6 0 247.9 0 255.5s3 15 8.5 20.4l195.6 195.7c5.4 5.4 12.7 8.4 20.4 8.4s15-3 20.4-8.4l194.7-194.7c5.4-5.4 8.4-12.8 8.4-20.4s-3-15-8.4-20.4"></path></svg>
</div>
<div class="md-source__repository">
User Documentation Repository
</div>
</a>
</div>
</nav>
<nav class="md-tabs" aria-label="Tabs" data-md-component="tabs">
<div class="md-grid">
<ul class="md-tabs__list">
<li class="md-tabs__item">
<a href="../../.." class="md-tabs__link">
Home
</a>
</li>
<li class="md-tabs__item">
<a href="../../../news/" class="md-tabs__link">
News
</a>
</li>
<li class="md-tabs__item">
<a href="../../../merlin7/01-Quick-Start-Guide/introduction/" class="md-tabs__link">
Merlin 7
</a>
</li>
<li class="md-tabs__item md-tabs__item--active">
<a href="../../introduction/" class="md-tabs__link">
Merlin 6
</a>
</li>
<li class="md-tabs__item">
<a href="../../../meg/introduction/" class="md-tabs__link">
MeG
</a>
</li>
<li class="md-tabs__item">
<a href="../../../cscs-userlab/introduction/" class="md-tabs__link">
PSI@CSCS
</a>
</li>
<li class="md-tabs__item">
<a href="../../../support/introduction/" class="md-tabs__link">
Support
</a>
</li>
</ul>
</div>
</nav>
</header>
<div class="md-container" data-md-component="container">
<main class="md-main" data-md-component="main">
<div class="md-main__inner md-grid">
<div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation">
<div class="md-sidebar__scrollwrap">
<div class="md-sidebar__inner">
<nav class="md-nav md-nav--primary md-nav--lifted" aria-label="Navigation" data-md-level="0">
<label class="md-nav__title" for="__drawer">
<a href="../../.." title="HPCE User Documentation" class="md-nav__button md-logo" aria-label="HPCE User Documentation" data-md-component="logo">
<img src="../../../images/hpce_logo.png" alt="logo">
</a>
HPCE User Documentation
</label>
<div class="md-nav__source">
<a href="https://gitea.psi.ch/hpce/gitea-pages" title="Go to repository" class="md-source" data-md-component="source">
<div class="md-source__icon md-icon">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M439.6 236.1 244 40.5c-5.4-5.5-12.8-8.5-20.4-8.5s-15 3-20.4 8.4L162.5 81l51.5 51.5c27.1-9.1 52.7 16.8 43.4 43.7l49.7 49.7c34.2-11.8 61.2 31 35.5 56.7-26.5 26.5-70.2-2.9-56-37.3L240.3 199v121.9c25.3 12.5 22.3 41.8 9.1 55-6.4 6.4-15.2 10.1-24.3 10.1s-17.8-3.6-24.3-10.1c-17.6-17.6-11.1-46.9 11.2-56v-123c-20.8-8.5-24.6-30.7-18.6-45L142.6 101 8.5 235.1C3 240.6 0 247.9 0 255.5s3 15 8.5 20.4l195.6 195.7c5.4 5.4 12.7 8.4 20.4 8.4s15-3 20.4-8.4l194.7-194.7c5.4-5.4 8.4-12.8 8.4-20.4s-3-15-8.4-20.4"></path></svg>
</div>
<div class="md-source__repository">
User Documentation Repository
</div>
</a>
</div>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../../.." class="md-nav__link">
<span class="md-ellipsis">
Home
</span>
</a>
</li>
<li class="md-nav__item md-nav__item--nested">
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2">
<div class="md-nav__link md-nav__container">
<a href="../../../news/" class="md-nav__link ">
<span class="md-ellipsis">
News
</span>
</a>
<label class="md-nav__link " for="__nav_2" id="__nav_2_label" tabindex="0">
<span class="md-nav__icon md-icon"></span>
</label>
</div>
<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
<label class="md-nav__title" for="__nav_2">
<span class="md-nav__icon md-icon"></span>
News
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item md-nav__item--nested">
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2">
<label class="md-nav__link" for="__nav_2_2" id="__nav_2_2_label" tabindex="0">
<span class="md-ellipsis">
Archive
</span>
<span class="md-nav__icon md-icon"></span>
</label>
<nav class="md-nav" data-md-level="2" aria-labelledby="__nav_2_2_label" aria-expanded="false">
<label class="md-nav__title" for="__nav_2_2">
<span class="md-nav__icon md-icon"></span>
Archive
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../../../news/archive/2026/" class="md-nav__link">
<span class="md-ellipsis">
2026
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../news/archive/2024/" class="md-nav__link">
<span class="md-ellipsis">
2024
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../news/archive/2019/" class="md-nav__link">
<span class="md-ellipsis">
2019
</span>
</a>
</li>
</ul>
</nav>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item md-nav__item--nested">
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3">
<label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="0">
<span class="md-ellipsis">
Merlin 7
</span>
<span class="md-nav__icon md-icon"></span>
</label>
<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
<label class="md-nav__title" for="__nav_3">
<span class="md-nav__icon md-icon"></span>
Merlin 7
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item md-nav__item--nested">
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3_1">
<label class="md-nav__link" for="__nav_3_1" id="__nav_3_1_label" tabindex="0">
<span class="md-ellipsis">
Quick Start Guide
</span>
<span class="md-nav__icon md-icon"></span>
</label>
<nav class="md-nav" data-md-level="2" aria-labelledby="__nav_3_1_label" aria-expanded="false">
<label class="md-nav__title" for="__nav_3_1">
<span class="md-nav__icon md-icon"></span>
Quick Start Guide
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../../../merlin7/01-Quick-Start-Guide/introduction/" class="md-nav__link">
<span class="md-ellipsis">
Introduction
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../merlin7/01-Quick-Start-Guide/code-of-conduct/" class="md-nav__link">
<span class="md-ellipsis">
Code Of Conduct
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../merlin7/01-Quick-Start-Guide/requesting-accounts/" class="md-nav__link">
<span class="md-ellipsis">
Requesting Merlin Accounts
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../merlin7/01-Quick-Start-Guide/requesting-projects/" class="md-nav__link">
<span class="md-ellipsis">
Requesting a Merlin Project
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../merlin7/01-Quick-Start-Guide/accessing-interactive-nodes/" class="md-nav__link">
<span class="md-ellipsis">
Accessing Interactive Nodes
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../merlin7/01-Quick-Start-Guide/accessing-slurm/" class="md-nav__link">
<span class="md-ellipsis">
Accessing Slurm Cluster
</span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item md-nav__item--nested">
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3_2">
<label class="md-nav__link" for="__nav_3_2" id="__nav_3_2_label" tabindex="0">
<span class="md-ellipsis">
How To Use Merlin7
</span>
<span class="md-nav__icon md-icon"></span>
</label>
<nav class="md-nav" data-md-level="2" aria-labelledby="__nav_3_2_label" aria-expanded="false">
<label class="md-nav__title" for="__nav_3_2">
<span class="md-nav__icon md-icon"></span>
How To Use Merlin7
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../../../merlin7/02-How-To-Use-Merlin/connect-from-linux/" class="md-nav__link">
<span class="md-ellipsis">
Connecting from a Linux Client
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../merlin7/02-How-To-Use-Merlin/connect-from-windows/" class="md-nav__link">
<span class="md-ellipsis">
Connecting from a Windows Client
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../merlin7/02-How-To-Use-Merlin/connect-from-macos/" class="md-nav__link">
<span class="md-ellipsis">
Connecting from a MacOS Client
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../merlin7/02-How-To-Use-Merlin/storage/" class="md-nav__link">
<span class="md-ellipsis">
Merlin7 Storage
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../merlin7/02-How-To-Use-Merlin/transfer-data/" class="md-nav__link">
<span class="md-ellipsis">
Transferring Data
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../merlin7/02-How-To-Use-Merlin/archive/" class="md-nav__link">
<span class="md-ellipsis">
Archive &amp; PSI Data Catalog
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../merlin7/02-How-To-Use-Merlin/nomachine/" class="md-nav__link">
<span class="md-ellipsis">
Remote Desktop Access to Merlin7
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../merlin7/02-How-To-Use-Merlin/merlin-rmount/" class="md-nav__link">
<span class="md-ellipsis">
Using merlin_rmount
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../merlin7/02-How-To-Use-Merlin/merlin_tools/" class="md-nav__link">
<span class="md-ellipsis">
Merlin7 Tools
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../merlin7/02-How-To-Use-Merlin/ssh-keys/" class="md-nav__link">
<span class="md-ellipsis">
Configuring SSH Keys in Merlin
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../merlin7/02-How-To-Use-Merlin/kerberos/" class="md-nav__link">
<span class="md-ellipsis">
Kerberos and AFS authentication
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../merlin7/02-How-To-Use-Merlin/software-repositories/" class="md-nav__link">
<span class="md-ellipsis">
Software repositories
</span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item md-nav__item--nested">
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3_3">
<label class="md-nav__link" for="__nav_3_3" id="__nav_3_3_label" tabindex="0">
<span class="md-ellipsis">
Slurm General Documentation
</span>
<span class="md-nav__icon md-icon"></span>
</label>
<nav class="md-nav" data-md-level="2" aria-labelledby="__nav_3_3_label" aria-expanded="false">
<label class="md-nav__title" for="__nav_3_3">
<span class="md-nav__icon md-icon"></span>
Slurm General Documentation
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../../../merlin7/03-Slurm-General-Documentation/merlin7-configuration/" class="md-nav__link">
<span class="md-ellipsis">
Slurm cluster 'merlin7'
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../merlin7/03-Slurm-General-Documentation/slurm-configuration/" class="md-nav__link">
<span class="md-ellipsis">
Slurm merlin7 Configuration
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../merlin7/03-Slurm-General-Documentation/interactive-jobs/" class="md-nav__link">
<span class="md-ellipsis">
Running Interactive Jobs
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../merlin7/03-Slurm-General-Documentation/slurm-examples/" class="md-nav__link">
<span class="md-ellipsis">
Slurm Examples
</span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item md-nav__item--nested">
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3_4">
<label class="md-nav__link" for="__nav_3_4" id="__nav_3_4_label" tabindex="0">
<span class="md-ellipsis">
Jupyterhub
</span>
<span class="md-nav__icon md-icon"></span>
</label>
<nav class="md-nav" data-md-level="2" aria-labelledby="__nav_3_4_label" aria-expanded="false">
<label class="md-nav__title" for="__nav_3_4">
<span class="md-nav__icon md-icon"></span>
Jupyterhub
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../../../merlin7/04-Jupyterhub/jupyterhub/" class="md-nav__link">
<span class="md-ellipsis">
Jupyterhub on Merlin7
</span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item md-nav__item--nested">
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3_5">
<label class="md-nav__link" for="__nav_3_5" id="__nav_3_5_label" tabindex="0">
<span class="md-ellipsis">
Software Support
</span>
<span class="md-nav__icon md-icon"></span>
</label>
<nav class="md-nav" data-md-level="2" aria-labelledby="__nav_3_5_label" aria-expanded="false">
<label class="md-nav__title" for="__nav_3_5">
<span class="md-nav__icon md-icon"></span>
Software Support
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../../../merlin7/05-Software-Support/pmodules/" class="md-nav__link">
<span class="md-ellipsis">
PSI Modules
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../merlin7/05-Software-Support/spack/" class="md-nav__link">
<span class="md-ellipsis">
Spack
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../merlin7/05-Software-Support/openmpi/" class="md-nav__link">
<span class="md-ellipsis">
OpenMPI Support
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../merlin7/05-Software-Support/ansys/" class="md-nav__link">
<span class="md-ellipsis">
ANSYS
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../merlin7/05-Software-Support/ansys-rsm/" class="md-nav__link">
<span class="md-ellipsis">
ANSYS RSM (Remote Resolve Manager)
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../merlin7/05-Software-Support/cp2k/" class="md-nav__link">
<span class="md-ellipsis">
CP2k
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../merlin7/05-Software-Support/quantum-espresso/" class="md-nav__link">
<span class="md-ellipsis">
Quantum Espresso
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../merlin7/05-Software-Support/lammps/" class="md-nav__link">
<span class="md-ellipsis">
LAMMPS
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../merlin7/05-Software-Support/gromacs/" class="md-nav__link">
<span class="md-ellipsis">
GROMACS
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../merlin7/05-Software-Support/opal-x/" class="md-nav__link">
<span class="md-ellipsis">
OPAL-X
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../merlin7/05-Software-Support/ippl/" class="md-nav__link">
<span class="md-ellipsis">
IPPL
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../merlin7/05-Software-Support/cray-module.env/" class="md-nav__link">
<span class="md-ellipsis">
Cray Programming Environment
</span>
</a>
</li>
</ul>
</nav>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested">
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" checked>
<label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="">
<span class="md-ellipsis">
Merlin 6
</span>
<span class="md-nav__icon md-icon"></span>
</label>
<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="true">
<label class="md-nav__title" for="__nav_4">
<span class="md-nav__icon md-icon"></span>
Merlin 6
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item md-nav__item--section md-nav__item--nested">
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4_1">
<label class="md-nav__link" for="__nav_4_1" id="__nav_4_1_label" tabindex="">
<span class="md-ellipsis">
Quick Start Guide
</span>
<span class="md-nav__icon md-icon"></span>
</label>
<nav class="md-nav" data-md-level="2" aria-labelledby="__nav_4_1_label" aria-expanded="false">
<label class="md-nav__title" for="__nav_4_1">
<span class="md-nav__icon md-icon"></span>
Quick Start Guide
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../../introduction/" class="md-nav__link">
<span class="md-ellipsis">
About Merlin6
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../quick-start-guide/code-of-conduct/" class="md-nav__link">
<span class="md-ellipsis">
Code Of Conduct
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../quick-start-guide/requesting-accounts/" class="md-nav__link">
<span class="md-ellipsis">
Requesting Merlin Accounts
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../quick-start-guide/requesting-projects/" class="md-nav__link">
<span class="md-ellipsis">
Requesting a Merlin Project
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../quick-start-guide/accessing-interactive-nodes/" class="md-nav__link">
<span class="md-ellipsis">
Accessing Interactive Nodes
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../quick-start-guide/accessing-slurm/" class="md-nav__link">
<span class="md-ellipsis">
Accessing Slurm Cluster
</span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item md-nav__item--section md-nav__item--nested">
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4_2">
<label class="md-nav__link" for="__nav_4_2" id="__nav_4_2_label" tabindex="">
<span class="md-ellipsis">
How To Use Merlin
</span>
<span class="md-nav__icon md-icon"></span>
</label>
<nav class="md-nav" data-md-level="2" aria-labelledby="__nav_4_2_label" aria-expanded="false">
<label class="md-nav__title" for="__nav_4_2">
<span class="md-nav__icon md-icon"></span>
How To Use Merlin
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../../how-to-use-merlin/connect-from-linux/" class="md-nav__link">
<span class="md-ellipsis">
Connecting from a Linux Client
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../how-to-use-merlin/connect-from-windows/" class="md-nav__link">
<span class="md-ellipsis">
Connecting from a Windows Client
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../how-to-use-merlin/connect-from-macos/" class="md-nav__link">
<span class="md-ellipsis">
Connecting from a MacOS Client
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../how-to-use-merlin/storage/" class="md-nav__link">
<span class="md-ellipsis">
Merlin6 Storage
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../how-to-use-merlin/transfer-data/" class="md-nav__link">
<span class="md-ellipsis">
Transferring Data
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../how-to-use-merlin/archive/" class="md-nav__link">
<span class="md-ellipsis">
Archive &amp; PSI Data Catalog
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../how-to-use-merlin/ssh-keys/" class="md-nav__link">
<span class="md-ellipsis">
Configuring SSH Keys in Merlin
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../how-to-use-merlin/kerberos/" class="md-nav__link">
<span class="md-ellipsis">
Kerberos and AFS authentication
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../how-to-use-merlin/using-modules/" class="md-nav__link">
<span class="md-ellipsis">
Using PModules
</span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item md-nav__item--section md-nav__item--nested">
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4_3">
<label class="md-nav__link" for="__nav_4_3" id="__nav_4_3_label" tabindex="">
<span class="md-ellipsis">
Slurm General Documentation
</span>
<span class="md-nav__icon md-icon"></span>
</label>
<nav class="md-nav" data-md-level="2" aria-labelledby="__nav_4_3_label" aria-expanded="false">
<label class="md-nav__title" for="__nav_4_3">
<span class="md-nav__icon md-icon"></span>
Slurm General Documentation
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../../slurm-general-docs/slurm-basic-commands/" class="md-nav__link">
<span class="md-ellipsis">
Slurm Basic Commands
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../slurm-general-docs/running-jobs/" class="md-nav__link">
<span class="md-ellipsis">
Running Slurm Scripts
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../slurm-general-docs/interactive-jobs/" class="md-nav__link">
<span class="md-ellipsis">
Running Interactive Jobs
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../slurm-general-docs/slurm-examples/" class="md-nav__link">
<span class="md-ellipsis">
Slurm Examples
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../slurm-general-docs/monitoring/" class="md-nav__link">
<span class="md-ellipsis">
Monitoring
</span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item md-nav__item--section md-nav__item--nested">
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4_4">
<label class="md-nav__link" for="__nav_4_4" id="__nav_4_4_label" tabindex="">
<span class="md-ellipsis">
GPU Cluster
</span>
<span class="md-nav__icon md-icon"></span>
</label>
<nav class="md-nav" data-md-level="2" aria-labelledby="__nav_4_4_label" aria-expanded="false">
<label class="md-nav__title" for="__nav_4_4">
<span class="md-nav__icon md-icon"></span>
GPU Cluster
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../../../gmerlin6/cluster-introduction/" class="md-nav__link">
<span class="md-ellipsis">
Introduction
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../gmerlin6/hardware-and-software-description/" class="md-nav__link">
<span class="md-ellipsis">
Hardware And Software Description
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../gmerlin6/slurm-configuration/" class="md-nav__link">
<span class="md-ellipsis">
Slurm cluster 'gmerlin6'
</span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested">
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4_5" checked>
<label class="md-nav__link" for="__nav_4_5" id="__nav_4_5_label" tabindex="">
<span class="md-ellipsis">
Jupyterhub
</span>
<span class="md-nav__icon md-icon"></span>
</label>
<nav class="md-nav" data-md-level="2" aria-labelledby="__nav_4_5_label" aria-expanded="true">
<label class="md-nav__title" for="__nav_4_5">
<span class="md-nav__icon md-icon"></span>
Jupyterhub
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../jupyterhub/" class="md-nav__link">
<span class="md-ellipsis">
Jupyterhub on Merlin
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../jupyter-examples/" class="md-nav__link">
<span class="md-ellipsis">
Jupyter examples on merlin6
</span>
</a>
</li>
<li class="md-nav__item md-nav__item--active">
<input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
<label class="md-nav__link md-nav__link--active" for="__toc">
<span class="md-ellipsis">
Jupytext - efficient editing
</span>
<span class="md-nav__icon md-icon"></span>
</label>
<a href="./" class="md-nav__link md-nav__link--active">
<span class="md-ellipsis">
Jupytext - efficient editing
</span>
</a>
<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
<label class="md-nav__title" for="__toc">
<span class="md-nav__icon md-icon"></span>
Table of contents
</label>
<ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
<li class="md-nav__item">
<a href="#creating-a-paired-file-in-python-format-for-efficient-refactoring" class="md-nav__link">
<span class="md-ellipsis">
Creating a paired file in python format for efficient refactoring
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#creating-a-paired-file-in-mardown-format-for-efficient-text-authoring" class="md-nav__link">
<span class="md-ellipsis">
Creating a paired file in mardown format for efficient text authoring
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#disable-autosaving-when-working-on-the-paired-file" class="md-nav__link">
<span class="md-ellipsis">
Disable autosaving when working on the paired file
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#further-information" class="md-nav__link">
<span class="md-ellipsis">
Further information
</span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="../jupyter-extensions/" class="md-nav__link">
<span class="md-ellipsis">
Jupyter Extensions
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../jupyterlab/" class="md-nav__link">
<span class="md-ellipsis">
Jupyterlab User interface
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../jupyterhub-trouble/" class="md-nav__link">
<span class="md-ellipsis">
Jupyterhub Troubleshooting
</span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item md-nav__item--section md-nav__item--nested">
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4_6">
<label class="md-nav__link" for="__nav_4_6" id="__nav_4_6_label" tabindex="">
<span class="md-ellipsis">
Software Support
</span>
<span class="md-nav__icon md-icon"></span>
</label>
<nav class="md-nav" data-md-level="2" aria-labelledby="__nav_4_6_label" aria-expanded="false">
<label class="md-nav__title" for="__nav_4_6">
<span class="md-nav__icon md-icon"></span>
Software Support
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../../software-support/ansys/" class="md-nav__link">
<span class="md-ellipsis">
ANSYS
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../software-support/ansys-rsm/" class="md-nav__link">
<span class="md-ellipsis">
ANSYS - RSM
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../software-support/ansys-cfx/" class="md-nav__link">
<span class="md-ellipsis">
ANSYS - CFX
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../software-support/ansys-fluent/" class="md-nav__link">
<span class="md-ellipsis">
ANSYS - Fluent
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../software-support/ansys-mapdl/" class="md-nav__link">
<span class="md-ellipsis">
ANSYS - MAPDL
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../software-support/ansys-hfss/" class="md-nav__link">
<span class="md-ellipsis">
ANSYS HFSS (ElectroMagnetics)
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../software-support/gothic/" class="md-nav__link">
<span class="md-ellipsis">
GOTHIC
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../software-support/merlin-rmount/" class="md-nav__link">
<span class="md-ellipsis">
merlin_rmount
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../software-support/impi/" class="md-nav__link">
<span class="md-ellipsis">
Intel MPI Support
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../software-support/openmpi/" class="md-nav__link">
<span class="md-ellipsis">
OpenMPI
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../software-support/paraview/" class="md-nav__link">
<span class="md-ellipsis">
ParaView
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../software-support/python/" class="md-nav__link">
<span class="md-ellipsis">
Python
</span>
</a>
</li>
</ul>
</nav>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item md-nav__item--nested">
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5">
<label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
<span class="md-ellipsis">
MeG
</span>
<span class="md-nav__icon md-icon"></span>
</label>
<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
<label class="md-nav__title" for="__nav_5">
<span class="md-nav__icon md-icon"></span>
MeG
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../../../meg/introduction/" class="md-nav__link">
<span class="md-ellipsis">
The MEG local HPC cluster
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../meg/contact/" class="md-nav__link">
<span class="md-ellipsis">
Support
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../meg/migration-to-merlin7/" class="md-nav__link">
<span class="md-ellipsis">
Meg to Merlin7 Migration Guide
</span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item md-nav__item--nested">
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6">
<label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
<span class="md-ellipsis">
PSI@CSCS
</span>
<span class="md-nav__icon md-icon"></span>
</label>
<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
<label class="md-nav__title" for="__nav_6">
<span class="md-nav__icon md-icon"></span>
PSI@CSCS
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../../../cscs-userlab/introduction/" class="md-nav__link">
<span class="md-ellipsis">
PSI HPC@CSCS
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../cscs-userlab/transfer-data/" class="md-nav__link">
<span class="md-ellipsis">
Transferring Data
</span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item md-nav__item--nested">
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7">
<label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
<span class="md-ellipsis">
Support
</span>
<span class="md-nav__icon md-icon"></span>
</label>
<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
<label class="md-nav__title" for="__nav_7">
<span class="md-nav__icon md-icon"></span>
Support
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../../../support/introduction/" class="md-nav__link">
<span class="md-ellipsis">
Getting Support
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../support/faq/" class="md-nav__link">
<span class="md-ellipsis">
FAQ
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../support/known-problems/" class="md-nav__link">
<span class="md-ellipsis">
Known Problems
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../support/troubleshooting/" class="md-nav__link">
<span class="md-ellipsis">
Troubleshooting
</span>
</a>
</li>
</ul>
</nav>
</li>
</ul>
</nav>
</div>
</div>
</div>
<div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc">
<div class="md-sidebar__scrollwrap">
<div class="md-sidebar__inner">
<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
<label class="md-nav__title" for="__toc">
<span class="md-nav__icon md-icon"></span>
Table of contents
</label>
<ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
<li class="md-nav__item">
<a href="#creating-a-paired-file-in-python-format-for-efficient-refactoring" class="md-nav__link">
<span class="md-ellipsis">
Creating a paired file in python format for efficient refactoring
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#creating-a-paired-file-in-mardown-format-for-efficient-text-authoring" class="md-nav__link">
<span class="md-ellipsis">
Creating a paired file in mardown format for efficient text authoring
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#disable-autosaving-when-working-on-the-paired-file" class="md-nav__link">
<span class="md-ellipsis">
Disable autosaving when working on the paired file
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#further-information" class="md-nav__link">
<span class="md-ellipsis">
Further information
</span>
</a>
</li>
</ul>
</nav>
</div>
</div>
</div>
<div class="md-content" data-md-component="content">
<article class="md-content__inner md-typeset">
<a href="https://gitea.psi.ch/hpce/gitea-pages/_edit/master/docs/merlin6/jupyterhub/jupytext.md" title="Edit this page" class="md-content__button md-icon" rel="edit">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4zm10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1z"></path></svg>
</a>
<h1 id="jupytext-efficient-editing">Jupytext - efficient editing<a class="headerlink" href="#jupytext-efficient-editing" title="Permanent link"></a></h1>
<p><a href="https://github.com/mwouts/jupytext">Jupytext</a> is a Jupyter serverextension
that allows creating a text file from a notebook that can be kept in sync with
it <strong>with the aim of using more efficient editors or IDEs on it</strong>. The file can
be created in a number of formats, e.g. <em>markdown, </em>.py (light Script)<em>, and
others. <code>Jupytext</code> will keep the both the notebook and this </em><em>paired</em>* file in
sync: If you save the paired file, changes will be carried over into the
notebook, and vice versa. This pairing will persist also in new sessions of
your notebook until you explicitely remove it again.</p>
<p>The paired file contains only the cell contents and not the output. Therefore
it also is <strong>much better suited for revision control</strong>, since the differences
between versions are limited to the cells and these file formats yield more
meaningful text differences than the default notebook storage format.</p>
<h2 id="creating-a-paired-file-in-python-format-for-efficient-refactoring">Creating a paired file in python format for efficient refactoring<a class="headerlink" href="#creating-a-paired-file-in-python-format-for-efficient-refactoring" title="Permanent link"></a></h2>
<p>From your notebook, go to the <code>file</code> menu and navigate to the <code>jupytext</code>
submenu. Select the <strong>light script</strong> pairing option. This will create a <code>*.py</code>
file version with the same basename as your notebook file.</p>
<figure>
<p><a class="glightbox" data-type="image" data-width="auto" data-height="auto" href="../../../images/jupyter/jupytext_menu.png" data-desc-position="bottom"><img alt="Jupytext menu" src="../../../images/jupyter/jupytext_menu.png"></a></p>
<figcaption></figcaption>
</figure>
<p>You can edit that file separately in your favourite python editor. The markdown
text parts will be conserved in the file in the form of python comments.</p>
<p>When you save the file and do a browser page reload of your jupyter notebook,
you will see all the changes carried over into your jupyter notebook.</p>
<h2 id="creating-a-paired-file-in-mardown-format-for-efficient-text-authoring">Creating a paired file in mardown format for efficient text authoring<a class="headerlink" href="#creating-a-paired-file-in-mardown-format-for-efficient-text-authoring" title="Permanent link"></a></h2>
<p>If you want to efficiently work on the descriptive text base of your notebook,
just pair it using the <code>Pair notebook with Markdown</code> menu item and edit the
generated <code>*.md</code> file with your favourite Markdown editor.</p>
<h2 id="disable-autosaving-when-working-on-the-paired-file">Disable autosaving when working on the paired file<a class="headerlink" href="#disable-autosaving-when-working-on-the-paired-file" title="Permanent link"></a></h2>
<p>Your notebooks usually auto save every 2 min (default). Turn this feature off
when working with the paired file. Otherwise Jupyter will continue to save the
state while you are editing the paired file, and the changes will be synced to
the disk version of the paired file. You can disable the autosave by unchecking
the <code>Autosave notebook</code> menu item in the Juytext menu (see above image).</p>
<h2 id="further-information">Further information<a class="headerlink" href="#further-information" title="Permanent link"></a></h2>
<p>Please refer to:</p>
<ul>
<li><a href="https://jupytext.readthedocs.io/en/latest/faq.html">the Jupytext FAQ</a></li>
<li><a href="https://jupytext.readthedocs.io/en/latest/index.html">the Jupytext documentation</a></li>
</ul>
</article>
</div>
<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
</div>
</main>
<footer class="md-footer">
<div class="md-footer-meta md-typeset">
<div class="md-footer-meta__inner md-grid">
<div class="md-copyright">
<div class="md-copyright__highlight">
Copyright © 2025 HPC and Emerging Technologies Group/CSD @ Paul Scherrer Institut
</div>
Made with
<a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
Material for MkDocs
</a>
</div>
</div>
</div>
</footer>
</div>
<div class="md-dialog" data-md-component="dialog">
<div class="md-dialog__inner md-typeset"></div>
</div>
<script id="__config" type="application/json">{"annotate": null, "base": "../../..", "features": ["navigation.instant", "navigation.tabs", "navigation.tabs.sticky", "navigation.sections", "navigation.indexes", "toc.follow", "content.action.edit"], "search": "../../../assets/javascripts/workers/search.7a47a382.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
<script src="../../../assets/javascripts/bundle.e71a0d61.min.js"></script>
<script id="init-glightbox">const lightbox = GLightbox({"touchNavigation": true, "loop": false, "zoomable": true, "draggable": true, "openEffect": "zoom", "closeEffect": "zoom", "slideEffect": "slide"});
document$.subscribe(()=>{ lightbox.reload(); });
</script></body></html>
Reference in New Issue View Git Blame Copy Permalink