Skip to content

Commit b2b9cea

Browse files
committed
Merge branch 'master' into staging
2 parents d8e6e8a + 720a184 commit b2b9cea

71 files changed

Lines changed: 2641 additions & 1569 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

.github/workflows/publish-prod.yml

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,7 @@
33
name: publish-prod
44

55
# Controls when the workflow will run
6-
on:
7-
workflow_dispatch:
6+
on: workflow_dispatch
87

98
jobs:
109

.github/workflows/publish-qa.yml

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,6 @@ on:
77
push:
88
branches:
99
- master
10-
- staging
1110
workflow_dispatch:
1211

1312
jobs:

.gitignore

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,4 @@
11
deploy_key
22
.DS_Store
3-
.idea/
3+
.idea/
4+
*.lic

.vscode/settings.json

Lines changed: 0 additions & 14 deletions
This file was deleted.

LICENSE

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
MIT License
2+
3+
Copyright (c) 2026 GroupDocs.Conversion Product Family
4+
5+
Permission is hereby granted, free of charge, to any person obtaining a copy
6+
of this software and associated documentation files (the "Software"), to deal
7+
in the Software without restriction, including without limitation the rights
8+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9+
copies of the Software, and to permit persons to whom the Software is
10+
furnished to do so, subject to the following conditions:
11+
12+
The above copyright notice and this permission notice shall be included in all
13+
copies or substantial portions of the Software.
14+
15+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21+
SOFTWARE.

README.md

Lines changed: 32 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,33 @@
1-
Public documentation for GroupDocs.Conversion
1+
# GroupDocs.Conversion - Documentation Source Files
22

3+
This repository contains Markdown files used to generate [GroupDocs.Conversion](https://docs.groupdocs.com/conversion/) static documentation.
4+
5+
## About GroupDocs.Conversion
6+
7+
[GroupDocs.Conversion](https://products.groupdocs.com/conversion/) is a document conversion SDK that enables you to convert files between 100+ formats including PDF, Word, Excel, PowerPoint, images, and more.
8+
9+
Available for .NET, Java, Node.js, and Python.
10+
11+
## Repository Purpose
12+
13+
The files in this repository are used to:
14+
15+
- Build and maintain the official [documentation](https://docs.groupdocs.com/conversion/).
16+
- Ensure documentation is always up-to-date with the latest product release.
17+
- Provide a consistent structure for automated builds and publication.
18+
19+
## How to Use
20+
21+
This repository is not meant for direct use, as it contains source files for generating static content with Hugo.
22+
23+
## Resources
24+
25+
- [Product Page](https://products.groupdocs.com/conversion/)
26+
- [Documentation](https://docs.groupdocs.com/conversion/)
27+
- [API Reference](https://reference.groupdocs.com/conversion/)
28+
- [Free Support Forum](https://forum.groupdocs.com/c/conversion/)
29+
- [Blog](https://blog.groupdocs.com/category/conversion/)
30+
31+
## License
32+
33+
This repository contains documentation source files and is licensed under the [MIT License](LICENSE).

build_docs.cmd

Lines changed: 10 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -2,11 +2,15 @@ set PRODUCT=conversion
22

33
call git submodule update --init --recursive
44
call git submodule foreach git pull origin master
5-
xcopy java common\content\%PRODUCT%\java /s /e /Y /i
6-
xcopy net common\content\%PRODUCT%\net /s /e /Y /i
7-
xcopy nodejs-java common\content\%PRODUCT%\nodejs-java /s /e /Y /i
8-
xcopy python-net common\content\%PRODUCT%\python-net /s /e /Y /i
9-
xcopy _index.md common\content\%PRODUCT%
5+
6+
REM Use robocopy /MIR to mirror the source into common/content — unlike xcopy,
7+
REM /MIR removes files in the destination that no longer exist in the source,
8+
REM so moved/renamed pages don't leave stale copies behind that cause Hugo
9+
REM REF_NOT_FOUND or 404s on _output_files downloads.
10+
robocopy java common\content\%PRODUCT%\java /MIR /NFL /NDL /NJH /NJS /NP
11+
robocopy net common\content\%PRODUCT%\net /MIR /NFL /NDL /NJH /NJS /NP
12+
robocopy nodejs-java common\content\%PRODUCT%\nodejs-java /MIR /NFL /NDL /NJH /NJS /NP
13+
robocopy python-net common\content\%PRODUCT%\python-net /MIR /NFL /NDL /NJH /NJS /NP
14+
xcopy _index.md common\content\%PRODUCT% /Y
1015
cd common
1116
call hugo server
12-

build_docs.sh

Lines changed: 10 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -3,10 +3,15 @@ export PRODUCT=conversion
33

44
git submodule update --init --recursive
55
git submodule foreach git pull origin master
6-
mkdir -p common/content/$PRODUCT/java && cp -r java common/content/$PRODUCT/
7-
mkdir -p common/content/$PRODUCT/net && cp -r net common/content/$PRODUCT/
8-
mkdir -p common/content/$PRODUCT/nodejs-java && cp -r nodejs-java common/content/$PRODUCT/
9-
mkdir -p common/content/$PRODUCT/python-net && cp -r python-net common/content/$PRODUCT/
10-
cp -r _index.md common/content/$PRODUCT
6+
7+
# Use rsync --delete to mirror the source into common/content — unlike cp -r,
8+
# --delete removes destination files that no longer exist in the source, so
9+
# moved/renamed pages don't leave stale copies that cause Hugo REF_NOT_FOUND
10+
# errors or 404s on _output_files downloads.
11+
for sub in java net nodejs-java python-net; do
12+
mkdir -p "common/content/$PRODUCT/$sub"
13+
rsync -a --delete "$sub/" "common/content/$PRODUCT/$sub/"
14+
done
15+
cp _index.md "common/content/$PRODUCT/"
1116
cd common
1217
hugo server

python-net/_index.md

Lines changed: 24 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -3,22 +3,39 @@ id: home
33
url: conversion/python-net
44
title: GroupDocs.Conversion for Python via .NET
55
weight: 1
6-
description: "GroupDocs.Conversion for Python via .NET is a document conversion API that enables easy conversion of popular file formats, including DOCX, XLSX, PPTX, PDF, CAD drawings, and many more."
7-
keywords: GroupDocs.Conversion for Python via .NET, document conversion, convert files, Python, file format conversion
6+
description: "Native Python library that converts documents between 10,000+ format pairs — DOCX, PDF, XLSX, PPTX, images, CAD, email, and archives — on Windows, Linux, and macOS. No Microsoft Office or Adobe Acrobat required."
7+
keywords: GroupDocs.Conversion, Python via .NET, document conversion, convert files, PDF, DOCX, XLSX, PPTX, CAD, image, email, archive, eBook, on-premise, Windows, Linux, macOS
88
productName: GroupDocs.Conversion for Python via .NET
99
hideChildren: true
10+
toc: True
1011
structuredData:
1112
showOrganization: true
1213
---
1314

1415
<img src="/conversion/python-net/_images/home.svg" alt="groupdocs-conversion-python-via-net-home" align="left" style="width:110px; margin: 0 30px 30px 0"/>
1516

16-
{{< button style="primary" link="https://releases.groupdocs.com/conversion/python-net/release-notes/" >}} <svg class="gdoc-icon gdoc-product-doc__btn-icon"><use xlink:href="/img/groupdocs-stack.svg#document"></use></svg> Release notes {{< /button >}}
17-
{{< button style="primary" link="https://releases.groupdocs.com/conversion/python-net/" >}} {{< icon "gdoc_download" >}} Download package {{< /button >}}
18-
{{< button style="primary" link="https://products.groupdocs.app/conversion/total" >}} <svg class="gdoc-icon gdoc-product-doc__btn-icon"><use xlink:href="/img/groupdocs-stack.svg#app"></use></svg> Online app {{< /button >}}
17+
<img src="https://img.shields.io/pypi/v/groupdocs-conversion-net?label=GroupDocs.Conversion%20PyPI" alt="PyPI package">
18+
<img src="https://img.shields.io/pypi/dm/groupdocs-conversion-net?label=pypi%20downloads" alt="PyPI downloads">
19+
20+
{{< button style="primary" link="https://releases.groupdocs.com/conversion/python-net/release-notes/" >}} <svg class="gdoc-icon gdoc-product-doc__btn-icon"><use xlink:href="/img/groupdocs-stack.svg#document"></use></svg> Release notes {{< /button >}}
21+
{{< button style="primary" link="https://pypi.org/project/groupdocs-conversion-net/" >}} {{< icon "gdoc_download" >}} Download from PyPI {{< /button >}}
22+
{{< button style="primary" link="https://products.groupdocs.app/conversion/total" >}} <svg class="gdoc-icon gdoc-product-doc__btn-icon"><use xlink:href="/img/groupdocs-stack.svg#app"></use></svg> Online app {{< /button >}}
1923

2024
[GroupDocs.Conversion for Python via .NET](https://products.groupdocs.com/conversion/python-net/) is a document conversion API that enables easy conversion of popular file formats, including DOCX, XLSX, PPTX, PDF, CAD drawings, and more. It preserves layout and formatting, offering extensive customization options for each format.
2125

26+
<div style="clear:left"></div>
27+
28+
## Quick example
29+
30+
```python
31+
from groupdocs.conversion import Converter
32+
from groupdocs.conversion.options.convert import PdfConvertOptions
33+
34+
# Convert a DOCX file to PDF
35+
with Converter("business-plan.docx") as converter:
36+
converter.convert("business-plan.pdf", PdfConvertOptions())
37+
```
38+
2239
## Features
2340

2441
- **Wide Format Support**: Supports over 10,000 conversion pairs across popular formats like Microsoft Office, PDF, HTML, and more.
@@ -27,7 +44,7 @@ structuredData:
2744

2845
## Supported File Formats
2946

30-
GroupDocs.Conversion supports a wide range of file formats. For a complete list, see the [full list of supported formats]({{< ref "conversion/python-net/supported-file-formats" >}}).
47+
GroupDocs.Conversion supports a wide range of file formats. For a complete list, see the [full list of supported formats]({{< ref "conversion/python-net/getting-started/supported-document-formats.md" >}}).
3148

3249
- **Microsoft Office** (Word, Excel, PowerPoint)
3350
- **PDF** (Standard PDFs, PDF/A)
@@ -42,7 +59,7 @@ GroupDocs.Conversion supports a wide range of file formats. For a complete list,
4259

4360
## Getting Started
4461

45-
To get started, refer to the [System Requirements]({{< ref "conversion/python-net/system-requirements" >}}), [Supported File Formats]({{< ref "conversion/python-net/supported-file-formats" >}}), [Installation]({{< ref "conversion/python-net/getting-started/installation" >}}), and [Quick Start Guide]({{< ref "conversion/python-net/getting-started/quick-start-guide" >}}) sections for setup instructions.
62+
To get started, refer to the [System Requirements]({{< ref "conversion/python-net/getting-started/system-requirements.md" >}}), [Supported File Formats]({{< ref "conversion/python-net/getting-started/supported-document-formats.md" >}}), [Installation]({{< ref "conversion/python-net/getting-started/installation" >}}), and [Quick Start Guide]({{< ref "conversion/python-net/getting-started/quick-start-guide" >}}) sections for setup instructions.
4663

4764
## Developer Guide
4865

0 commit comments

Comments
 (0)