Skrypt jest aplikacją PowerShell, która wykorzystuje Windows Forms w celu stworzenia graficznego interfejsu użytkownika (GUI) umożliwiającego konwersję plików z jednego formatu na inny za pomocą narzędzia Pandoc. W skrócie, skrypt umożliwia użytkownikowi wybór pliku wejściowego, pliku wyjściowego oraz formatów wejściowych i wyjściowych obsługiwanych przez Pandoc.

Mi personalnie ten skrypt przydaje się wieloktronie kiedy tylko coś tworzę. Zwyklę jak coś piszę to jest to w kilku formatach. Jeden to syntax dokuwiki który jest wykorzystywany tutaj na tej stronie, bardzo często też wiele rzeczy które piszę są napisane w LaTeX'u i jeszcze zdarza mi się coś napisać w MarkDownie. Pandoc to narzędzie które pozwala na łatwą konwersję pomiędzy tymi formatami.

Spora część artykułów na tej wiki została przekonwertowana za pomocą tego skryptu z formatów .md i .tex.

Skrypt ładuje dwie biblioteki .NET, które umożliwiają stworzenie interfejsu graficznego:

• System.Windows.Forms – do obsługi GUI (okna, przyciski, itp.)
• System.Drawing – do operacji graficznych

Skrypt definiuje dwie listy zawierające formaty wejściowe oraz wyjściowe obsługiwane przez Pandoc:

• `$availableInputFormats` – lista formatów plików, które mogą być użyte jako dane wejściowe (np. markdown, docx, bibtex).
• `$availableOutputFormats` – lista formatów plików, które mogą być generowane jako dane wyjściowe (np. pdf, html, docx, dokuwiki).

Użytkownik wybiera formaty z rozwijanych list (ComboBox) w GUI.

Skrypt tworzy formularz z następującymi elementami:

• Pole tekstowe do wyboru pliku wejściowego (Input File).
• Pole tekstowe do wyboru pliku wyjściowego (Output File).
• Przyciski „Browse…” do przeglądania plików wejściowych i wyjściowych.
• Kombinacje rozwijane (ComboBox) do wyboru formatów wejściowych i wyjściowych.
• Przycisk „Convert” do uruchomienia konwersji.
• Przycisk „Cancel” do anulowania operacji.

Po kliknięciu przycisku „Convert”, skrypt sprawdza, czy użytkownik wybrał pliki wejściowe i wyjściowe. Jeśli któryś z nich jest pusty, wyświetlany jest komunikat o błędzie.

Jeśli plik wejściowy ma rozszerzenie `.tex` i użytkownik wybierze format „texinfo”, skrypt automatycznie zmienia format wejściowy na „latex”, ponieważ Pandoc wymaga, by pliki TeX były konwertowane jako „latex”, a nie „texinfo”.

Skrypt sprawdza, czy Pandoc jest zainstalowany i dostępny w systemie (sprawdzając polecenie `pandoc`). Jeśli Pandoc nie jest dostępny, użytkownik otrzymuje odpowiedni komunikat o błędzie.

Jeśli wszystkie warunki są spełnione, skrypt uruchamia polecenie Pandoc, przekazując odpowiednie argumenty:

• `-f` – format wejściowy
• `-t` – format wyjściowy
• `-o` – plik wyjściowy

Po zakończeniu konwersji wyświetlany jest komunikat o sukcesie.

Skrypt zapewnia łatwy sposób konwertowania plików między wieloma formatami, oferując użytkownikowi prosty interfejs graficzny do wyboru plików i formatów. Obsługuje różnorodne formaty wejściowe i wyjściowe obsługiwane przez Pandoc oraz zapewnia walidację danych i obsługę błędów.