Method previewRmd

src/rmarkdown/preview.ts:198–237

(viewer: vscode.ViewColumn, uri?: vscode.Uri)

    public async previewRmd(viewer: vscode.ViewColumn, uri?: vscode.Uri): Promise<void> {
        const textEditor = vscode.window.activeTextEditor;
        if (!textEditor) {
            void vscode.window.showErrorMessage('No text editor active.');
            return;
        }

        const filePath = uri ? uri.fsPath : textEditor.document.uri.fsPath;
        const fileName = path.basename(filePath);
        const currentViewColumn: vscode.ViewColumn = vscode.window.activeTextEditor?.viewColumn ?? vscode.ViewColumn.Active ?? vscode.ViewColumn.One;

        // handle untitled rmd files
        if (!uri && textEditor.document.isUntitled) {
            void vscode.window.showWarningMessage('Cannot knit an untitled file. Please save the document.');
            await vscode.commands.executeCommand('workbench.action.files.save').then(() => {
                if (!textEditor.document.isUntitled) {
                    void this.previewRmd(viewer);
                }
            });
            return;
        }

        const isSaved = uri ?
            true :
            await saveDocument(textEditor.document);

        if (!isSaved) {
            return;
        }
        // don't knit if the current uri is already being knit
        if (this.busyUriStore.has(filePath)) {
            return;
        } else if (this.previewStore.has(filePath)) {
            this.previewStore.get(filePath)?.panel.reveal();
        } else {
            this.busyUriStore.add(filePath);
            await this.previewDocument(filePath, fileName, viewer, currentViewColumn);
            this.busyUriStore.delete(filePath);
        }
    }

    public enableAutoRefresh(preview?: RMarkdownPreview): void {
        if (preview) {