',
- html,
- re.DOTALL,
- )
-
- if symlink_match:
- name = symlink_match.group(2)
- section = symlink_match.group(3)
- logger.info(
- f"{man_file.display_name} detected as symlink to {name}({section})"
- )
- html = self._generate_redirect_html({"name": name, "section": section})
-
- man_file.html_content = html
- output_path = self._get_output_path(man_file)
- man_file.html_path = output_path
- output_path.parent.mkdir(parents=True, exist_ok=True)
- with open(output_path, "w", encoding="utf-8") as f:
- f.write(html)
-
- logger.debug(f"Converted {man_file.display_name} -> {output_path}")
- return True
-
- except Exception as e:
- logger.error(f"Error converting {man_file.display_name}: {e}")
- return False
-
- def convert_many(
- self, man_files: List[tuple], max_workers: int = 10
- ) -> List[ManFile]:
- """Convert multiple man pages in parallel.
-
- Args:
- man_files: List of (ManFile, content) tuples
- max_workers: Maximum number of parallel conversions
-
- Returns:
- List of successfully converted ManFile objects
- """
- converted = []
-
- with ThreadPoolExecutor(max_workers=max_workers) as executor:
- future_to_manfile = {
- executor.submit(self.convert, man_file, content): man_file
- for man_file, content in man_files
- }
-
- for future in as_completed(future_to_manfile):
- man_file = future_to_manfile[future]
- try:
- if future.result():
- converted.append(man_file)
- except Exception as e:
- logger.error(f"Error converting {man_file.display_name}: {e}")
-
- logger.info(f"Converted {len(converted)}/{len(man_files)} man pages to HTML")
- return converted
-
- def _run_mandoc(self, content: str) -> Optional[str]:
- """Run mandoc to convert man page to HTML.
-
- Args:
- content: Raw man page content
-
- Returns:
- HTML output from mandoc, or None on error
- """
- try:
- result = subprocess.run(
- ["mandoc", "-T", "html", "-O", "fragment,toc"],
- input=content.encode("utf-8"),
- capture_output=True,
- timeout=30,
- )
-
- if result.returncode != 0:
- stderr = result.stderr.decode("utf-8", errors="replace")
- logger.warning(f"mandoc returned error: {stderr}")
- if result.stdout:
- return result.stdout.decode("utf-8", errors="replace")
- return None
-
- return result.stdout.decode("utf-8", errors="replace")
-
- except subprocess.TimeoutExpired:
- logger.error("mandoc conversion timed out")
- return None
- except Exception as e:
- logger.error(f"Error running mandoc: {e}")
- return None
-
- def _clean_html(self, html: str) -> str:
- """Clean up mandoc HTML output.
-
- Args:
- html: Raw HTML from mandoc
-
- Returns:
- Cleaned HTML
- """
- # Fix empty header cells
- html = re.sub(
- r'
\(\)
',
- r'
',
- html,
- )
-
- # Remove empty tags (from .sp directives in troff)
- html = re.sub(r'
\s*
', '', html)
-
- # Clean up trailing whitespace and br tags in pre blocks
- # Match:
...
and clean trailing followed by whitespace
- def clean_pre_block(match):
- content = match.group(1)
- # Remove trailing tags and whitespace before closing
- content = re.sub(r'\s*$', '', content)
- content = re.sub(r'\s+$', '', content)
- return f'
{content}
'
-
- html = re.sub(r'
(.*?)
', clean_pre_block, html, flags=re.DOTALL)
-
- html = html.strip()
-
- return html
-
- def _generate_redirect_html(self, target_info: dict) -> str:
- """Generate HTML for a symlink/redirect page.
-
- Args:
- target_info: Dict with 'name' and 'section' of target man page
-
- Returns:
- HTML fragment for redirect page
- """
- name = target_info["name"]
- section = target_info["section"]
- target_filename = f"{name}.{section}.html"
-
- html = f'''