不幸的是，我对Mercurial了解不多，但我可以为您提供一个与Git一起工作的可能解决方案，希望您能够将我的Git命令转换为对应的Mercurial命令。

对于后台，在Git中，add命令将对文件所做的更改存储到暂存区域。完成此操作后，Git将忽略对文件的任何后续更改，除非您告诉它也执行这些更改。因此，下面的脚本，对于每个给定的文件，剥离所有的outputs和prompt_number sections，阶段性剥离文件，然后恢复原始文件:

如果运行这个脚本会得到类似ImportError: No module named IPython.nbformat的错误消息，那么使用ipython而不是python来运行脚本。

from IPython.nbformat import current
import io
from os import remove, rename
from shutil import copyfile
from subprocess import Popen
from sys import argv


for filename in argv[1:]:
# Backup the current file
backup_filename = filename + ".backup"
copyfile(filename,backup_filename)


try:
# Read in the notebook
with io.open(filename,'r',encoding='utf-8') as f:
notebook = current.reads(f.read(),format="ipynb")


# Strip out all of the output and prompt_number sections
for worksheet in notebook["worksheets"]:
for cell in worksheet["cells"]:
cell.outputs = []
if "prompt_number" in cell:
del cell["prompt_number"]


# Write the stripped file
with io.open(filename, 'w', encoding='utf-8') as f:
current.write(notebook,f,format='ipynb')


# Run git add to stage the non-output changes
print("git add",filename)
Popen(["git","add",filename]).wait()


finally:
# Restore the original file;  remove is needed in case
# we are running in windows.
remove(filename)
rename(backup_filename,filename)

在您想要提交更改的文件上运行脚本之后，只需运行git commit。

这是我的解决方案与git。它允许你像往常一样添加和提交(和diff):这些操作不会改变你的工作树，同时(重新)运行一个笔记本不会改变你的git历史。

虽然这可能适用于其他VSC，但我知道它不能满足您的要求(至少VSC不可知)。不过，它对我来说是完美的，尽管它没有什么特别出色的地方，而且很多人可能已经在使用它了，但我没有通过谷歌找到关于如何实现它的明确说明。所以它可能对其他人有用。

1. 保存一个有这个内容的文件(对于下面的内容，让我们假设是~/bin/ipynb_output_filter.py)

2. 让它可执行(chmod +x ~/bin/ipynb_output_filter.py)

3. 创建文件~/.gitattributes，包含以下内容

   *。ipynb过滤器= dropoutput_ipynb

4. 执行以下命令:

   git配置全局核心。attributesfile ~ / .gitattributes Git配置——global filter.dropoutput_ipynb。干净的~ / bin / ipynb_output_filter.py Git配置——global filter.dropoutput_ipynb。涂抹猫< / p >

完成了!

限制:

• 它只适用于git
• 在git中，如果你在somebranch分支中执行git checkout otherbranch; git checkout somebranch，你通常期望工作树是不变的。在这里，您将丢失两个分支之间的源不同的笔记本的输出和单元格编号。
• 更一般地说，输出完全没有版本控制，就像Gregory的解决方案一样。为了不只是在每次执行涉及签出的操作时都将其丢弃，可以通过将其存储在单独的文件中来改变方法(但请注意，在运行上述代码时，提交id是未知的!)，并可能对它们进行版本控制(但请注意，这将需要比git commit notebook_file.ipynb更多的东西，尽管它至少可以使git diff notebook_file.ipynb免于base64垃圾)。
• 也就是说，顺便提一下，如果你提取了包含一些输出的代码(即由其他人不使用这种方法提交的代码)，输出将正常检出。只有当地生产的产品会损失。

我的解决方案反映了这样一个事实:我个人不喜欢对生成的东西进行版本控制——注意，涉及输出的合并几乎肯定会使输出或和生产力或都失效。

编辑:

• 如果你确实采用了我建议的解决方案——也就是说，全局的——你会遇到麻烦，因为一些git会把想要回购到版本输出。因此，如果你想要禁用特定git存储库的输出过滤，只需在其中创建一个文件. /信息/属性, with

  **ipynb过滤器=

作为内容。显然，可以以同样的方式进行相反的操作:为特定的存储库启用筛选只有。

• 代码现在维护在它自己的git存储库

• 如果上面的说明导致ImportErrors，尝试添加"ipython"在脚本路径之前:

    git config --global filter.dropoutput_ipynb.clean ipython ~/bin/ipynb_output_filter.py
  

编辑: 2016年5月(2017年2月更新):我的脚本有几个替代方案-为了完整性，这里是我知道的列表:nbstripout (其他 变体)， nbstrip， 金桥。

我使用一个非常务实的方法;它适用于多个笔记本，在多个侧面。它甚至可以让我四处“转移”笔记本。它适用于Windows和Unix/MacOS Al认为很简单，就是解决上面的问题

概念

这些.py-files包含所有输入;非代码保存为注释，单元格边界也是如此。这些文件可以读取/导入(并拖动)到笔记本服务器以(重新)创建一个笔记本。只有输出消失了;直到它重新运行。

我个人使用水银来版本跟踪.py文件;并使用普通(命令行)命令进行添加、签入(等等)。大多数其他(D) vc都允许这样做。

现在追溯历史很简单;.py是小的，文本的和简单的区分。偶尔，我们需要一个克隆(只是分支;在那里启动第二个笔记本服务器)，或者旧版本(签出并导入到笔记本服务器中)，等等。

提示,技巧

• 将* .ipynb添加到.hgignore，这样Mercurial就知道它可以忽略这些文件
• 创建一个(bash)脚本来启动服务器(使用--script选项)并对其进行版本跟踪
保存笔记本确实保存了# eyz0文件，但是不是否签入了它。
• 这是缺点:人们可以忘记这一点
• 它也是功能:可以在不集群存储库历史的情况下保存一个笔记本(并在以后继续)。
李< / ul > < / >

祝愿

• 如果在笔记本仪表板中有一个签到/添加/等按钮就好了
签出到(例如)file@date+rev.py应该是有帮助的 要加上这一点，工作量太大了;也许我会这样做一次。到目前为止，我都是手工完成的

我们有一个合作项目，产品是Jupyter笔记本，我们在过去的六个月里使用了一种非常有效的方法:我们自动激活保存.py文件，并跟踪.ipynb文件和.py文件。

这样，如果有人想查看/下载最新的笔记本，他们可以通过github或nbviewer来完成，如果有人想查看笔记本代码是如何变化的，他们可以只查看.py文件的变化。

对于Jupyter笔记本服务器，这可以通过添加行来完成

import os
from subprocess import check_call


def post_save(model, os_path, contents_manager):
"""post-save hook for converting notebooks to .py scripts"""
if model['type'] != 'notebook':
return # only do this for notebooks
d, fname = os.path.split(os_path)
check_call(['jupyter', 'nbconvert', '--to', 'script', fname], cwd=d)


c.FileContentsManager.post_save_hook = post_save

到jupyter_notebook_config.py文件并重新启动笔记本服务器。

如果您不确定在哪个目录中找到您的jupyter_notebook_config.py文件，您可以键入jupyter --config-dir，如果您在那里没有找到该文件，您可以键入jupyter notebook --generate-config来创建它。

对于Ipython 3笔记本服务器，这可以通过添加行来完成

import os
from subprocess import check_call


def post_save(model, os_path, contents_manager):
"""post-save hook for converting notebooks to .py scripts"""
if model['type'] != 'notebook':
return # only do this for notebooks
d, fname = os.path.split(os_path)
check_call(['ipython', 'nbconvert', '--to', 'script', fname], cwd=d)


c.FileContentsManager.post_save_hook = post_save

到ipython_notebook_config.py文件并重新启动笔记本服务器。这些台词来自一个github问题的答案@minrk提供和@dror包括他们在他的SO答案以及。

对于Ipython 2笔记本服务器，这可以通过启动服务器来完成:

ipython notebook --script

或者加上这条直线

c.FileNotebookManager.save_script = True

到ipython_notebook_config.py文件并重新启动笔记本服务器。

如果您不确定在哪个目录中找到您的ipython_notebook_config.py文件，您可以键入ipython locate profile default，如果您在那里没有找到该文件，您可以键入ipython profile create来创建它。

这是我们在github上的项目就是使用这种方法，这是Github的例子，探索笔记本电脑最近的变化。

我们对此非常满意。

我做了阿尔伯特&Rich做了——不要给.ipynb文件做版本(因为这些文件可能包含图像，这会变得混乱)。相反，总是运行ipython notebook --script或在配置文件中放置c.FileNotebookManager.save_script = True，以便在保存笔记本时始终创建.py文件(可控制版本)。

为了重新生成笔记本(在签出回购或切换分支之后)，我将脚本py_file_to_notebooks.py放在我存储笔记本的目录中。

现在，签出一个回购之后，只需运行python py_file_to_notebooks.py来生成ipynb文件。切换分支后，您可能必须运行python py_file_to_notebooks.py -ov来覆盖现有的ipynb文件。

编辑:我不再这样做了，因为(A)每次签出分支时，你都必须从py文件中重新生成你的笔记本，(B)在笔记本中有其他东西，如markdown，你会丢失。相反，我使用git过滤器从笔记本中剥离输出。关于如何做到这一点的讨论是在这里。

下面是Cyrille rosant为IPython 3.0提供的一个新解决方案，它坚持标记文件，而不是基于json的ipymd文件:

https://github.com/rossant/ipymd < a href = " https://github.com/rossant/ipymd " > < / >

正如前面指出的，--script在3.x中被弃用了。这种方法可以通过应用后保存钩子来使用。特别地，在ipython_notebook_config.py中添加以下内容:

import os
from subprocess import check_call


def post_save(model, os_path, contents_manager):
"""post-save hook for converting notebooks to .py scripts"""
if model['type'] != 'notebook':
return # only do this for notebooks
d, fname = os.path.split(os_path)
check_call(['ipython', 'nbconvert', '--to', 'script', fname], cwd=d)


c.FileContentsManager.post_save_hook = post_save

代码取自# 8009。

好吧，所以看起来目前最好的解决方案，根据讨论在这里，是使一个git过滤器自动剥离ipynb文件的输出提交。

以下是我让它工作的方法(摘自讨论):

还添加了文件.gitattributes文件到repo的根目录，包含:

*.ipynb filter=stripoutput

并创建了一个setup_git_filters.sh包含

git config filter.stripoutput.clean "$(git rev-parse --show-toplevel)/relative/path/to/strip_notebook_output"
git config filter.stripoutput.smudge cat
git config filter.stripoutput.required true

并运行source setup_git_filters.sh。花哨的$(git rev-parse…)事情是找到你的回购在任何(Unix)机器上的本地路径。

接下来是Pietro Battiston编写的优秀脚本，如果您遇到这样的Unicode解析错误:

Traceback (most recent call last):
File "/Users/kwisatz/bin/ipynb_output_filter.py", line 33, in <module>
write(json_in, sys.stdout, NO_CONVERT)
File "/Users/kwisatz/anaconda/lib/python2.7/site-packages/IPython/nbformat/__init__.py", line 161, in write
fp.write(s)
UnicodeEncodeError: 'ascii' codec can't encode character u'\u2014' in position 11549: ordinal not in range(128)

你可以在脚本开头添加:

reload(sys)
sys.setdefaultencoding('utf8')

我基于MinRKs要点创建了nbstripout，它同时支持Git和Mercurial(感谢mforbes)。它既可以在命令行中独立使用，也可以作为过滤器使用，可以通过nbstripout install / nbstripout uninstall轻松安装在当前存储库中。

从PyPI或简单地获取它

pip install nbstripout

(2017 - 02)

策略

<李> on_commit ():
• 去掉输出>的名称。ipynb (nbstripout)
• 清除输出> name.clean.ipynb (nbstripout，)
• python: name.ipynb.py (nbconvert)
• 始终转换为markdown: name.ipynb.md (nbconvert， ipymd)
李< / ul > < / > <李> vcs.configure ():
• Git difftool, mergetool: nbdiff和nbmerge from nbdime
李< / ul > < / >

工具

• nbstripout:从笔记本上剥离输出
  • src: # EYZ0
  • Src: https://github.com/kynan/nbstripout
    • # EYZ0
    李< / ul > < / > 李< / ul > < / >
    • ipynb_output_filter:从笔记本上剥离输出
      • src: # EYZ0
      李< / ul > < / >
      • ipymd:转换{Jupyter, Markdown, O'Reilly Atlas Markdown, OpenDocument， .py}
        • src: # EYZ0
        李< / ul > < / > “工具的差异和合并的Jupyter笔记本。”(2015)
        • src: # EYZ0
        • 文档:
          
          小开

          我已经构建了一个python包来解决这个问题

          https://github.com/brookisme/gitnb

          它提供了一个CLI，使用git启发的语法来跟踪/更新/区分git repo中的笔记本。

          这里有一个例子

          # add a notebook to be tracked
          gitnb add SomeNotebook.ipynb
          
          
          # check the changes before commiting
          gitnb diff SomeNotebook.ipynb
          
          
          # commit your changes (to your git repo)
          gitnb commit -am "I fixed a bug"
          

          注意最后一步，我使用“gitnb commit”的地方是提交到你的git repo。它本质上是一个包装

          # get the latest changes from your python notebooks
          gitnb update
          
          
          # commit your changes ** this time with the native git commit **
          git commit -am "I fixed a bug"
          

          还有更多的方法，并且可以配置为在每个阶段需要或多或少的用户输入，但这是总体思想。