-
Notifications
You must be signed in to change notification settings - Fork 29
Polski
- Ogólne zastosowanie
- Dostosowywanie konfiguracji
-
Markdown
- Podelement
- Drukowanie innych formatów renderowanych
- Rozwiązywanie problemów
Istnieje kilka sposobów drukowania.
- Aktywny dokument można wydrukować za pomocą ikony lub menu kontekstowego.
- Możesz wydrukować wybór z aktywnego dokumentu, za pomocą ikony lub menu kontekstowego.
- Możesz wydrukować jeden lub więcej plików bezpośrednio z panelu eksploratora plików, za pomocą menu kontekstowego w folderze, pliku lub wielu plikach.
- Pliki mogą być tytułowane za pomocą ich ścieżki do pliku. Tytuł nie pojawia się w dokumencie, ale może być używany w nagłówkach w niektórych przeglądarkach.
- Możesz wybrać jeden z następujących formatów.
- Brak ścieżki
- Skrócony (np.
D:\...\folder-zawierający\plik.ext) - Względny obszar roboczy
- Możesz wybrać jeden z następujących formatów.
- Ścieżka plików może być wyświetlana jako nagłówek na początku dokumentu.
- Ustawienie określa, czy mają być używane względne czy bezwzględne ścieżki plików.
- Pliki nienależące do obszaru roboczego zawsze używają wartości bezwzględnej.
- Ścieżki bezwzględne są konwertowane na ścieżki tyldowe, gdy znajdują się w katalogu domowym użytkownika.
- Ustawienie określa, czy nagłówek ścieżki pliku pojawia się na początku indywidualnie drukowanych plików.
- Listy wykluczeń dotyczą zarówno wybranych folderów, jak i plików. Ich celem jest ignorowanie niedrukowalnych plików binarnych.
Dokumenty Markdown mogą być renderowane i stylizowane. Jest to szczegółowo opisane w sekcji Markdown.
Aby wydrukować aktywny dokument, wystarczy kliknąć ikonę drukarki po prawej stronie kart dokumentów. Upewnij się, że nie masz zaznaczonych wielu wierszy tekstu. W przeciwnym razie zostanie wydrukowane zaznaczenie, a nie cały dokument. Sterowanie rozmiarem papieru, marginesami i orientacją strony znajduje się w oknie dialogowym drukowania.
Zaznacz wielowierszowy blok tekstu w aktywnym dokumencie. Następnie kliknij ikonę drukarki po prawej stronie kart dokumentu lub kliknij prawym przyciskiem myszy zaznaczenie i wybierz Drukuj z menu kontekstowego. Gdy pojawi się menu kontekstowe, Drukuj pojawi się na górze, na dole lub nigdzie, w zależności od ustawienia Drukuj: Pozycja elementu menu kontekstowego edytora .
Numery wierszy na wydruku są wyrównywane z numerami wierszy w edytorze, niezależnie od tego, czy są one widoczne, czy nie. Jeśli więc omawiasz wiersz kodu o numerze 1145 w przeglądzie kodu i otworzysz plik, aby go zmienić, wpisanie Ctrl + G, a następnie 1145 [Enter] umieści kursor bezpośrednio na danym wierszu kodu.
Aby wydrukować plik inny niż aktywny dokument, znajdź go w okienku EKSPLORATOR i kliknij prawym przyciskiem myszy. W menu kontekstowym pliku polecenie Drukuj zawsze pojawia się w górnej części menu lub w jego pobliżu. Spowoduje to wydrukowanie całego pliku.
Jeśli naciśniesz F1 i wpiszesz folder wydruku, przekonasz się, że możesz wydrukować wszystkie pliki do wydrukowania w folderze zawierającym aktywny dokument. Tworzone jest pojedyncze zadanie drukowania, w którym wszystkie pliki są oddzielone nagłówkami z ich nazwami.
Większość z tych ustawień dostosowuje wrażenia użytkownika (ikona, lokalizacja menu itp.). Aby znaleźć te ustawienia, otwórz okienko ustawień programu VS Code i przejdź do pozycji Rozszerzenia/Drukowanie lub po prostu wyszukaj ciąg "drukowanie".
Poniżej znajduje się lista dostępnych nazw ustawień, które pojawiają się w pliku konfiguracyjnym.
-
print.alternateBrowser: włącz/wyłącz alternatywną przeglądarkę -
print.browserPath: ścieżka do przeglądarki internetowej -
print.colourScheme: arkusz stylów używany do kolorowania składni -
print.editorContextMenuItemPosition: pozycja ESC_CODESPAN_OPEN ESC_CODESPAN_CLOSE wydruku w menu kontekstowym edytora -
print.editorTitleMenuButton: pokaż przycisk drukowania w menu tytułu edytora -
print.fontSize: rozmiar czcionki (opcje od 6 do 13 pkt) -
print.formatMarkdown: renderuj Markdown jako stylizowany kod HTML podczas drukowania -
print.lineNumbers: wł., wyłącz lub dziedzicz (z edytora) -
print.lineSpacing: pojedyncze, półtorej linii lub podwójnie odstępne -
print.printAndClose: po wydrukowaniu zamknij przeglądarkę -
print.folder.include: wzorzec dla plików do dołączenia. Pusty pasuje do wszystkiego. -
print.folder.exclude: wzorce do wykluczenia -
print.folder.maxFiles: maksymalna liczba plików, dla których zawartość jest renderowana podczas drukowania folderu -
print.folder.maxLines: pliki zawierające więcej wierszy niż ten próg zostaną zignorowane -
print.logLevel: kontroluje poziom szczegółowości pliku dziennika -
print.filepathAsDocumentHeading: steruje użyciem ścieżki pliku jako nagłówka na początku dokumentu -
print.filepathAsDocumentTitle: kontroluje użycie ścieżki pliku jako tytułu dokumentu (używanego przez niektóre przeglądarki w nagłówku strony) -
print.filepathHeadingForIndividuallyPrintedDocuments: określa, czy nagłówek ścieżki pliku pojawia się na początku indywidualnie drukowanych dokumentów
Można określić, czy ikona drukowania ma być wyświetlana na pasku narzędzi po uaktywnieniu okienka edytora. To ustawienie jest oznaczone przycisku menu tytułu edytora.
Możesz kontrolować, czy element menu "Drukuj" pojawia się na górze, na dole, czy nigdzie w menu kontekstowym, korzystając z ustawienia ESC_CODESPAN_CLOSE pozycji menu kontekstowego edytora ESC_CODESPAN_OPEN.
Po zaznaczeniu ustawienia Drukuj i zamknij drukowanie spowoduje automatyczne otwarcie okna dialogowego Drukuj przeglądarki, a następnie automatyczne zamknięcie przeglądarki po wydrukowaniu lub anulowaniu. Wyłączenie tej opcji spowoduje otwarcie przeglądarki z wyrenderowanym dokumentem gotowym do inspekcji. Jeśli następnie ręcznie otworzysz okno dialogowe Drukuj, wydrukowanie lub anulowanie go nie spowoduje zamknięcia przeglądarki.
W momencie wydania tej wersji problemy z routingiem poleceń powodowały, że drukowanie ze zdalnych obszarów roboczych wracało do drukarki domyślnej. Pełna obsługa zostanie przywrócona tak szybko, jak to możliwe.
Domyślnie drukowanie odbywa się przy użyciu domyślnej przeglądarki. Jednak drukowanie działa najlepiej w przeglądarce pochodzącej z Chromium, a zmiana domyślnej przeglądarki może nie być możliwa lub pożądana.
Aby umożliwić drukowanie przy użyciu przeglądarki, która nie jest przeglądarką domyślną, można określić ścieżkę do alternatywnej przeglądarki, a także zaznaczyć pole wyboru umożliwiające włączanie i wyłączanie tej przeglądarki bez utraty ścieżki.
Ustawienia te są oznaczone odpowiednio ESC_CODESPAN_CLOSE Ścieżka przeglądarki i ESC_CODESPAN_OPEN alternatywnej przeglądarki.
Ścieżka do alternatywnej przeglądarki jest automatycznie cytowana w systemie Windows, a na platformach opartych na systemie Unix spacje są cytowane. Niestety jest to niekompatybilne z dostarczaniem opcji wiersza poleceń.
Jeśli musisz podać opcje wiersza polecenia, utwórz plik wsadowy (lub plik skryptu bash), który określa opcje, i odwołaj się do pliku skryptu bash w alternatywnej ścieżce przeglądarki.
Korzystając z ustawienia ESC_CODESPAN_CLOSE schematu kolorów ESC_CODESPAN_OPEN, można określić schemat kolorów używany do kolorowania składni. Wybór jest ograniczony do jasnych motywów, ponieważ drukarki używają białego papieru.
Jeśli drukowany jest aktywny dokument i istnieje zaznaczenie wielowierszowe, drukowane jest tylko zaznaczenie.
Krój pisma jest określany przez ustawienia edytora VS Code. Jeśli zobaczysz Fira Code na ekranie, zostanie on wydrukowany.
ESC_EM_OPEN ESC_EM_CLOSE rozmiaru drukowanego tekstu jest ustawieniem Drukuj, ponieważ rozmiar, który najlepiej sprawdza się na ekranie, może nie być rozmiarem, który najlepiej sprawdza się na papierze.
Jeśli zastanawiasz się, dlaczego nazywamy to krojem pisma, a nie czcionką, to dlatego, że czcionka to konkretny krój pisma w określonym rozmiarze i obróbce. "12pt Times italic" to czcionka. "Times" to krój pisma. Nie pomaga to, że Próbnik czcionek systemu Windows (który robi wybrać czcionki, musisz określić krój pisma, rozmiar i obróbkę) błędnie oznacza krój pisma jako "Czcionka".
Prawdopodobnie chcesz, aby zadania drukowania Markdown były renderowane i stylizowane, i jest to zachowanie domyślne. Jeśli chcesz wydrukować Markdown jako kod źródłowy, możesz odznaczyć ustawienie Drukuj: Renderuj Markdown .
Do drukowania kodu źródłowego arkusze stylów są dołączone do zestawu i można je wybrać według nazwy z listy. Wybór jest ograniczony do jasnych arkuszy stylów, ponieważ papier do drukarki jest biały, a atramenty i tonery do drukarek są przeznaczone do białego papieru.
- Tag linku do arkusza stylów można osadzić bezpośrednio w języku Markdown. Jest to specyficzne dla dokumentu.
- Istnieje ustawienie o nazwie
markdown.styles. To jest lista adresów URL. Zarówno wbudowany podgląd Markdown, jak i Drukuj będą honorować tę listę. Można użyć bezwzględnych adresów URL, względnych adresów URL obszaru roboczego lub względnych adresów URL dokumentów, jak pokazano w poniższym przykładzie.
"markdown.styles": [
"https://cdn.jsdelivr.net/npm/[email protected]/dist/katex.min.css",
"path/to/document/relative/custom.css",
"workspace.resource/path/to/stylesheet.css"
]Względne adresy URL obszaru roboczego to najlepszy sposób udostępniania zasobów między dokumentami. Znajdują się one w obszarze roboczym, dzięki czemu mogą być kontrolowane wraz z dokumentami, a ponieważ adres URL jest względny w stosunku do obszaru roboczego, a nie do dokumentu, można organizować (i reorganizować) dokumenty w folderach bez naruszania adresów URL. Zauważ, że dotyczy to nie tylko arkuszy stylów, ale także zasobów plików graficznych.
Mapowanie z Markdown do wygenerowanego kodu HTML jest oczywiste. Tabele stają się ESC_CODESPAN_CLOSE tabeli, ESC_CODESPAN_OPEN i td elementów. Pozycje są H1 do H9. Akapity są P elementów, punktory i numery są ul i starych elementów.
Nie zapominaj, że możesz osadzić HTML w Markdown, więc nic nie stoi na przeszkodzie, abyś użył div lub span zastosować klasę CSS do bloku lub przebiegu Markdown.
Wbudowany serwer WWW wiąże się tylko z adresem sprzężenia zwrotnego i akceptuje tylko połączenia, które są określone.
Katex zależy od CSS i czcionek z sieci. Aby drukowanie działało, musisz dodać wymagany arkusz stylów do swoich ustawień. Jeśli zauważysz, że jedna lub dwie rzeczy działają w podglądzie, ale nie są drukowane, określ aktualną wersję ze strony KaTeX i zaktualizuj adres URL.
"markdown.styles": [
"https://cdn.jsdelivr.net/npm/[email protected]/dist/katex.min.css"
]Jeśli chcesz odciąć przewód, zaimportuj zasoby Katex do projektu zgodnie z opisem w poprzedniej sekcji i użyj odwołania względnego obszaru roboczego.
Oto kilka przykładów, które pomogą Ci sprawdzić konfigurację.``` $$ \begin{alignedat}{2} 10&x+ &3&y = 2 \ 3&x+&13&y = 4 \end{alignedat} $$ and thus
## Renderowane znaczniki Markdown i zdalne obszary robocze
Aby pracować ze zdalnymi obszarami roboczymi, rozszerzenie Markdown musi działać na hoście zdalnym, ponieważ jest to miejsce, w którym jest uruchamiany potok renderowania języka Markdown. Rozszerzenia, takie jak Print, które są przeznaczone do użytku ze zdalnymi obszarami roboczymi, można wdrożyć na zdalnym hoście za pomocą jednego kliknięcia. Większość rozszerzeń Markdown może działać w ten sposób, ale nie są do tego skonfigurowane.
Niestety, rozszerzenia Markdown nie są zwykle skonfigurowane do użytku zdalnego; Projektanci spodziewali się, że będą one działać lokalnie.
### Samodzielne łatanie rozszerzeń Markdown
Jeśli Twoja potrzeba jest pilna, możesz samodzielnie załatać rozszerzenia.
1. Znajdź rozszerzenia, w których są zainstalowane na stacji roboczej w `~/.vscode/extensions` (w systemie Windows zastąp `%userprofile%` zamiast `~`)
2. Edytuj pliki `package.json` dla rozszerzeń języka Markdown, których chcesz używać na hostach zdalnych. Dodaj `extensionKind` jako atrybut poziomu głównego.
3. Po edytowaniu wszystkich rozszerzeń języka Markdown uruchom ponownie program VS Code.
4. Zainstaluj rozszerzenie na hoście zdalnym i popraw rozszerzenie na hoście zdalnym w ten sam sposób.
```json
...
"extensionKind": [
"workspace"
],
...
Poprawki takie jak ta zostaną utracone przy następnej aktualizacji rozszerzenia, więc jeśli poprawka zakończyła się pomyślnie, możesz przesłać żądanie ściągnięcia do wydawcy.
Zarejestrowano problemy z żądaniem renderowanego drukowania formatów innych niż Markdown. Przykłady obejmują nuty ze znaczników muzycznych ABC i notesów Jupyter Notebook. Aby to wesprzeć bez ponoszenia niemożliwych do opanowania obciążeń związanych z nadążaniem za każdym formatem dokumentu tekstowego używanym w programie VS Code, udostępniliśmy interfejs API i opublikowaliśmy zestaw SDK, który umożliwia opiekunom włączenie drukowania do funkcji podglądu.
W związku z tym, jeśli chcesz renderować drukowanie dla określonego formatu, dla którego masz już rozszerzenie zapewniające podgląd, zgłoś problem z wydawcą tego rozszerzenia. Wyjaśnij swoją chęć wydrukowania i skieruj je do druku i skierowania do
- Zacznij od upewnienia się, że możesz wydrukować stronę internetową z przeglądarki.
- Użytkownik, który jest uruchamiany w programie VS Code, musi mieć możliwość ustanowienia gniazda nasłuchiwania.
- Wygląda na to, że nic się nie dzieje — uruchom ponownie program VS Code.
- Przeglądarka uruchamia się, ale strona się nie ładuje — sprawdź uprawnienia sieciowe.
- Przeglądarka wyświetla komunikat o błędzie informujący o tym, że nie można odnaleźć pliku CSS — zainstalowano go z pliku VSIX, który nie został przez nas przygotowany. Pobierz oficjalny pakiet i spróbuj ponownie.
Jeśli coś jest nie tak lub masz pomysł na ulepszenie, zapraszamy do zarejestrowania problemu w repozytorium GitHub.
Używana przeglądarka będzie miała wpływ na Twoje wrażenia.
Aby uzyskać najlepsze wyniki drukowania, zainstaluj przeglądarkę opartą na Chromium lub Firefox. Jeśli nie chcesz, aby była to przeglądarka domyślna, skorzystaj z ustawień przeglądarki alternatywnej. W momencie wydania tej wersji problemy z routingiem poleceń powodowały, że drukowanie ze zdalnych obszarów roboczych wracało do drukarki domyślnej. Pełna obsługa zostanie przywrócona tak szybko, jak to możliwe.
Wiadomo, że poniższe elementy działają dobrze.- Odważny
- Chrom
- Chrom
- Brzeg
- Przeglądarka Firefox
- Edge Classic nie jest już obsługiwany.
- Przeglądarka Internet Explorer nie jest obsługiwana.
Aby korzystać z funkcji Drukuj z hostem zdalnym, należy zainstalować ją na hosta zdalnego.
Aby uzyskać korzyści z rozszerzenia Markdown podczas drukowania dokumentu z hosta zdalnego, rozszerzenie Markdown musi być skompilowane przy użyciu extensionKind ESC_CODESPAN_OPEN ESC_CODESPAN_CLOSE obszaru roboczego i musi być zainstalowane na hoście zdalnym.
Większość takich rozszerzeń nie jest tworzona dla ESC_CODESPAN_CLOSE obszaru roboczego. Można je trywialnie naprawić, modyfikując ich ESC_CODESPAN_OPEN package.json. Niestety ta ręczna łatka prawdopodobnie zostanie utracona za każdym razem, gdy rozszerzenie zostanie zaktualizowane, więc powinieneś zgłosić problem z autorem rozszerzeń, które łatasz.
W momencie wydania tej wersji problemy z routingiem poleceń powodowały, że drukowanie ze zdalnych obszarów roboczych wracało do drukarki domyślnej. Pełna obsługa zostanie przywrócona tak szybko, jak to możliwe.
Nie można podać opcji wiersza polecenia w alternatywnej ścieżce przeglądarki. W systemie Windows automatycznie umieszczamy cudzysłowy wokół ścieżki w przypadku spacji w nazwach plików lub folderów. Na innych platformach spacje są automatycznie zmieniane.
Zarówno automatyczne cytowanie, jak i zmiana znaczenia spacji są niezgodne z użyciem opcji wiersza poleceń. Rozwiązaniem jest utworzenie pliku wsadowego (lub skryptu powłoki), który uruchamia przeglądarkę z opcjami wiersza poleceń i dostarcza ścieżkę do pliku wsadowego (lub skryptu powłoki).
Chrome może zachowywać drukarkę, rozmiar papieru i wybrane marginesy między zadaniami drukowania. Niektóre opcje wiersza poleceń Chrome powodują zgłaszanie błędów, nawet jeśli drukowanie się powiedzie.
Niektóre wtyczki Chrome zakłócają stylizację zadań drukowania. Chociaż możliwe jest pomijanie wtyczek za pomocą --disable-plugins nie działa, gdy istnieje już uruchomiona instancja Chrome. Przełącznik ESC_CODESPAN_CLOSE ESC_CODESPAN_OPEN --incognito pomija wtyczki, gdy jest uruchomiona instancja, ale ma własne problemy.
Jeśli nadal ESC_EM_OPEN ESC_EM_CLOSE nie możesz uruchomić funkcji Drukuj, zgłosić problem w repozytorium. Postaramy się Ci pomóc.
Możemy poprosić Cię o zwiększenie poziomu rejestrowania, odtworzenie problemu, a następnie przesłanie nam dziennika.
Ustaw poziom rejestrowania za pomocą ustawienia ESC_CODESPAN_CLOSE Drukuj: Poziom dziennika. Domyślnie jest to błędów (minimalne rejestrowanie), ale możesz to obrócić do ESC_CODESPAN_OPEN debugowania, który jest bardzo szczegółowy, a nawet głupi, który będzie nawet rejestrował wywołania do modułu odśmiecania pamięci.