# Formula Editor

> Wpisz wzór w LaTeX, oglądaj go na bieżąco podczas pisania i wstaw do modułu jako obraz, który można ponownie otworzyć i zmienić.

Source: https://widgets.doorsnext.com/pl/widgets/formula-editor/

- Dyscyplina: Jakość treści
- Działa w: Moduł IBM DOORS Next
- Obsługiwane produkty: RM (IBM Engineering Requirements Management DOORS Next (Requirements Management))
- Zmienia dane
- Keywords: wzory matematyczne, LaTeX, równania w wymaganiach, edytor wzorów, MathJax, obraz wzoru, równania DOORS Next
- Wersja: 1.8 (Data wydania 2026-10-27)
- Vendor: SmarterProcess (https://doorsnext.com, info@smarterprocess.pl)
- Przebieg pracy: 1. Zaznacz artefakt w module → 2. Wpisz wzór w LaTeX → 3. Podgląd obrazu → 4. Potwierdź Insert lub Update → 5. Wzór zapisany jako obraz wraz z LaTeX → 6. Raport zmian w Excelu

## Czym jest i dlaczego powstał
Wymagania dotyczące hamulców, czujników czy pętli sterowania często potrzebują wzoru: drogi hamowania, tolerancji, filtru. DOORS Next nie ma edytora wzorów. Zespoły wklejają zrzut ekranu z Worda, którego nikt później nie zmieni bez oryginalnego pliku, albo wpisują wzór jako zwykły tekst, który trudno czytać.

Formula Editor pozwala pisać wzór w LaTeX bezpośrednio w DOORS Next. Rysuje wzór na bieżąco podczas pisania i wstawia go do modułu jako obraz, w nowym artefakcie po zaznaczonym albo w zaznaczonym artefakcie. LaTeX jest zapisywany razem z artefaktem, więc późniejsze zaznaczenie wzoru otwiera go ponownie w edytorze.

## Jakie problemy rozwiązuje
- Wzory wklejone jako zrzuty ekranu, których nikt nie zmieni bez pliku Worda, z którego pochodzą.
- Wzory wpisane jako zwykły tekst, np. s = v^2/(2*mu*g), trudne do czytania w przeglądach i eksportach.
- Obrazy wzorów, które nie pasują już do tekstu, bo jedno z nich zmieniono ręcznie.
- Przełączanie się do innego narzędzia i kopiowanie obrazów z powrotem przy każdym nowym lub zmienionym wzorze.

## Korzyści
- **Widać na bieżąco:** podgląd rysuje wzór podczas pisania i pokazuje rozmiar obrazu.
- **Można zmienić później:** LaTeX jest przechowywany w artefakcie, więc zaznaczenie wzoru otwiera go ponownie, a Update rysuje nowy obraz.
- **Tekst zostaje:** Update na artefakcie z tekstem dodaje wzór po tekście i zachowuje słowa.
- **Bez innej strony internetowej:** wzór rysuje MathJax w Twojej przeglądarce; nie jest wysyłany do edytora online.
- **Błędy wraz z miejscem:** brakujący nawias klamrowy lub nieznane polecenie jest pokazywane pod polem razem ze znakiem, w którym występuje.

## Jak używać
1. Otwórz moduł i zaznacz jeden artefakt.
2. Wpisz wzór w LaTeX albo klikaj przyciski pod polem: ułamek, pierwiastek, potęga, indeks, suma, całka, litera grecka, plus minus i macierz. **More symbols** pokazuje 21 kolejnych. Podgląd pokazuje obraz i jego rozmiar.
3. Kliknij **Insert**, aby dodać wzór w nowym artefakcie po zaznaczonym, albo **Update**, aby zapisać go w zaznaczonym artefakcie. Przeczytaj potwierdzenie i kliknij **Insert formula** lub **Update formula**.
4. Blok wyniku pokazuje, co zostało zrobione, a **Log** pobiera raport zmian.
5. Aby zmienić wzór, zaznacz go w module. Otworzy się w widżecie (**Editing 1531 …**); zmień LaTeX i kliknij **Update**.

## Warto wiedzieć
- Pracuj w zestawie zmian (change set), aby móc go odrzucić, jeśli wynik nie jest taki, jak trzeba. Nowy artefakt jest zapisywany od razu.
- Obraz to plik PNG zapisany na serwerze DOORS Next, rysowany w dwukrotnym rozmiarze, aby pozostał ostry na ekranach i w eksportach. **Settings** ma trzy rozmiary: S, M i L.
- LaTeX trafia do atrybutu o nazwie **Formula**, jeśli projekt go ma, i zawsze do opisu obrazu, więc wzór otwiera się ponownie także w projekcie bez tego atrybutu.
- Nowe artefakty dostają typ zaznaczonego artefaktu. W **Settings** możesz wybrać dla Insert inny typ artefaktu projektu; widżet zapamiętuje go osobno dla każdego projektu. Update zachowuje typ.
- Gdy obraz wzoru został ręcznie zastąpiony, widżet to sygnalizuje, a potwierdzenie Update ostrzega, że ta zmiana zostanie utracona. LaTeX zawsze wygrywa.