diff options
| author |   Unit 193 <unit193@unit193.net> | 2021-02-03 19:17:50 -0500 |
|---|---|---|
| committer | Unit 193 <unit193@unit193.net> | 2021-02-03 19:17:50 -0500 |
| commit | 475d074fd74425efbe783fad08f97f2df0c4909f (patch) | |
| tree | 2acdae53999b3c74b716efa4edb5b40311fa356a /scripts/debug_rebuilds/README.md | |
| parent | cd502d52787f666fff3254d7d7e7578930c813c2 (diff) | |
| parent | 3a0d66f07b112b6d2bdc2b57bbf717a89a351ce6 (diff) | |
Update upstream source from tag 'upstream/8.1.2'
Update to upstream version '8.1.2'
with Debian dir e5e966a9e6010ef70618dc9a61558fa4db35aceb
Diffstat (limited to 'scripts/debug_rebuilds/README.md')
| -rw-r--r-- | scripts/debug_rebuilds/README.md | 11 |
1 files changed, 11 insertions, 0 deletions
diff --git a/scripts/debug_rebuilds/README.md b/scripts/debug_rebuilds/README.md new file mode 100644 index 0000000..05305a9 --- /dev/null +++ b/scripts/debug_rebuilds/README.md @@ -0,0 +1,11 @@ +To debug unexpected Nikola rebuilds: + +1. In `nikola.utils.config_changed._calc_digest`, uncomment the line that says `self._write_into_debug_db(digest, data)` +2. Create a copy of your site source. +3. Run `python step1_build_and_dumpdb.py`. (It will delete cache/output/db, build the site twice, and write dumpdb to .py files) +4. Run `python step2_analyze_py_files.py | tee analysis.txt`. It will compare the two .py files, using `cc_debug.sqlite3` and `{first,second}_dump.py`. +5. Compare the produced dictionaries. Note that you will probably need a character-level diff tool, <https://prettydiff.com/> is pretty good as long as you change CSS for `li.replace` to `word-break: break-all; white-space: pre-wrap;` + +Copyright © 2019-2020, Chris Warrick. +Portions Copyright © Eduardo Nafuel Schettino and Doit Contributors. +License of .py files is MIT (same as Nikola) |