Skip to main content
Troubleshooting · files

Use when

A captured page warns page_pictures_truncated, or its pictures stop partway down the page.

Looking for something else?

A page captured with --pictures none, which keeps no pictures on purpose. A page whose text is missing (recipe Check that a File’s text arrived intact).

​
Signs

  • The operation of the page lists the warning page_pictures_truncated, with the number of pictures and the height of the page. penumbra files operations get <operation-id> --json shows its warnings.
  • penumbra files pages <file> stops after 20 pages, and the page is longer.
  • A citation near the end of the page shows no picture.

​
Why it happens

Penumbra cuts the picture of a captured page into strips from the top. A page keeps at most 20 strips. A page taller than that keeps the top 20 and warns. The text of the page is not cut. Search finds the text of the whole page, and penumbra files text <file> reads it.

​
What Penumbra does

By itself:
  • Cuts the picture of a page into strips from the top and keeps at most 20.
  • Warns page_pictures_truncated with the number of strips and the height of the page when a page is longer.
  • Keeps the text of the whole page, and search finds all of it.
  • Offers the kept pictures to search by page picture and to the viewer.
You must:
  • Tell the person which pages lost their lower pictures.
Not handled:
  • No option raises the 20 pictures of a page.

​
Do

  1. Read the warning. Note the page and its height.
  2. Tell the person that the pictures stop partway down and that the text is whole.
  3. If the person needs the lower part of the page, read it as text: penumbra files text <file>.
  4. If the page matters as a picture, the person can save the lower part as an image. Then upload it with penumbra files upload.

​
Don’t

  • Don’t save the page again to get more pictures. The project already holds it, and a second save reports it without capturing it (problem page-already-in-project).
  • Don’t tell the person that the page is missing. Its text is whole.

​
Check

  • penumbra files text <file> shows the text of the whole page.
  • penumbra files pages <file> lists at most 20 pages.
  • The person knows which pages have pictures for the top only.
Cards file and website. Recipes bring-in-a-website and check-file-text. Problem page-already-in-project.

​
Keep going

File · Website · Save web pages or crawl a website into the project · Check that a File’s text arrived intact · The project already holds the page