#8985 [azure] docs build fails with Pygments 2.8.0+
Closed: fixed by frenaud. Opened by slev.

As of 4.9.7 FreeIPA makes use of raw lexer in doc/designs/subordinate-ids.md.

raw alias has been removed in Pygments 2.8.0:
https://pygments.org/docs/changelog/#version-2-8-0
https://github.com/pygments/pygments/pull/1643

This causes the failure of Azure Docs job:

waiting for workers...
/__w/1/s/doc/designs/subordinate-ids.md:153: WARNING: Pygments lexer name 'raw' is not known
/__w/1/s/doc/designs/subordinate-ids.md:209: WARNING: Pygments lexer name 'raw' is not known
/__w/1/s/doc/designs/subordinate-ids.md:224: WARNING: Pygments lexer name 'raw' is not known
/__w/1/s/doc/designs/subordinate-ids.md:250: WARNING: Pygments lexer name 'raw' is not known
/__w/1/s/doc/designs/subordinate-ids.md:297: WARNING: Pygments lexer name 'raw' is not known
/__w/1/s/doc/designs/subordinate-ids.md:305: WARNING: Pygments lexer name 'raw' is not known
/__w/1/s/doc/designs/subordinate-ids.md:316: WARNING: Pygments lexer name 'raw' is not known
/__w/1/s/doc/designs/subordinate-ids.md:330: WARNING: Pygments lexer name 'raw' is not known
/__w/1/s/doc/designs/subordinate-ids.md:346: WARNING: Pygments lexer name 'raw' is not known
/__w/1/s/doc/designs/subordinate-ids.md:460: WARNING: Pygments lexer name 'raw' is not known
/__w/1/s/doc/designs/subordinate-ids.md:508: WARNING: Pygments lexer name 'raw' is not known
/__w/1/s/doc/designs/subordinate-ids.md:560: WARNING: Pygments lexer name 'raw' is not known
generating indices... genindex done
writing additional pages... search done
copying static files... done
copying extra files... done
dumping search index in English (code: en)... done
dumping object inventory... done
build finished with problems, 12 warnings.
make: *** [Makefile:24: html] Error 1

I think raw lexer can be replaced with text.

Note: F34 has Pygments 2.7.4 and that's why upstream CI passes.


Metadata Update from @slev:
- Issue assigned to slev

PR: https://github.com/freeipa/freeipa/pull/6010

master:

  • 0d33d21a0583d83ad0127e76183e17434c9a6d75 docs: Make use of text highlighting

ipa-4-9:

  • d1343e8f539679227c8dbfb58ba634810d3857da docs: Make use of text highlighting

Metadata Update from @frenaud:
- Issue close_status updated to: fixed
- Issue status updated to: Closed (was: Open)

Metadata