Quick Search

Visual Studio Code extension for quick web searches of selected text in the editor; you can select the search engine you want, the browser is the system default;

Note: Browser: It is an application (software) installed on your computer or phone, which interprets the HTML, CSS and JavaScript code of websites and shows you the graphic pages. Search Engine: It is a website (an online service) specialized in indexing and searching information across the web. When you type a keyword, the search engine scans its database and returns a list of relevant links. You open your browser (e.g., Microsoft Edge), type in the address of a search engine (e.g., duckduckgo.com), and use that engine to find the pages you're interested in. You can use any search engine within any browser (you can search Google using Firefox, or DuckDuckGo using Chrome). i don't use a webview as it is unstable with all search engines.

How To Use

vai nella sezione Extensions di vs code e digita Quick Search Clicker e installala.

• Seleziona il testo di vui vuoi fare una ricerca, tasto destro e dovrebbe apparire "search on the web" nel menù;
• una volta fatto dovrebbe appararire una textbox in cui scrivere cose aggiuntive per migliorare e completare la ricerca;
• seleziona il tipo di motore di ricerca.

How To Build

!!!!!! Fedora!!!!

1. Installa il pacchetto Node.js: sudo dnf install nodejs, verifica con: node -v npm -v

2. • Crea una cartella per i pacchetti globali nella tua home: mkdir ~/.npm-global,
   • Configura npm affinché usi questa nuova cartella: npm config set prefix '~/.npm-global'
   • Aggiungi il percorso al file di configurazione della tua shell (es. ~/.bashrc o ~/.zshrc) in modo che il sistema sappia dove trovare i comandi installati (come yo): echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc source ~/.bashrc

3. npm install -g yo generator-code

4. Il prossimo passo è far partire il generatore per creare la struttura del progetto, digita:yo code

Si aprirà un assistente interattivo nel terminale che ti farà alcune domande per configurare l'estensione. Ecco le scelte consigliate per iniziare: 1. What type of extension do you want to create? $\rightarrow$ Scegli New Extension (TypeScript) (è l'opzione predefinita e ti aiuta a evitare errori di scrittura del codice). 2. What's the name of your extension? $\rightarrow$ Scrivi il nome. 3. What's the identifier of your extension? $\rightarrow$ Premi semplicemente Invio per accettare quello consigliato. 4. What's the description? $\rightarrow$ Scrivi una breve descrizione . 5. Initialize a git repository? $\rightarrow$ Puoi mettere Yes se usi git. 6. Which package manager to use? $\rightarrow$ Scegli npm.

How To Run

1. modifica i file extension.ts e package.json: il primo per implementare la logica e tutto quanto, mentre il secondo serve per associare quello che crei a comandi dell'interfaccia di vs code, in "activationEvents" gli eventi da attivare e in "contributes" i vari comando/opzioni.
2. compila extension.ts con il comando: npm run compile, che chiama direttamente il compilatore di TypeScript e crea in out il file extension.js con il codice che hai scritto per poterlo farlo eseguire da vs code
3. clicca F5: si aprirà una nuova finestra di vs code per i Developer con la tua estensione già caricata(se tutto va bene), dove devi creare un file e testare le funzionalità della tua estensione. Se in qualche modo si bugga e hai sbagliato a selezionare il tipo di debugger, crea nella directory .vscode il file launch.json con scritto:

   // Use IntelliSense to learn about possible attributes.
   // Hover to view descriptions of existing attributes.
   // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
   "version": "0.2.0",
   "configurations": [
       {
           "args": [
               "--extensionDevelopmentPath=${workspaceFolder}"
           ],
           "name": "Launch Extension",
           "outFiles": [
               "${workspaceFolder}/out/**/*.js"
           ],
           "preLaunchTask": "npm",
           "request": "launch",
           "type": "extensionHost"
       }
   
   ]
   

}``` e in start debugging (che si trova se clicchi nella barra di ricerca sopra)scegli "Launch Extension" o "Extension Development Host".

How To Contribute

• Fai un Fork di questa repository, fai un git clone e mettila in locale, fai le modifiche che devi fare, segui la sezione sopra How To Run, fai commit in locale, pushali, fai una pull request.

How To Publish (For Me and in your personal project)

• lancia il comando: vsce package, uscirà fuori un file .vsix
• vai su qua, accedi e metti il .vsix lì.

How To Update (For Me and in your personal project)

• modifica il file package.json e cambia la versione, e poi lancia vsce package.
• vai sul marketplace, vai sulla tua estensione sui tre puntini, fai update, e metti il nuovo .vsix

Documentation

VS CODE API REFERENCE