Nenav

jQueryPrettify

Descrizione

Nenav è un plugin realizzato con jQuery e Prettify che consente la navigazione all'interno di una cartella contenente sorgenti di diversi tipi di linguaggi di programmazione, o più precisamente, contenente tutti i tipi di file di testo, con evidenziazione di sintassi relativa ai linguaggi per cui è configurato Prettify.

Il plugin è sicuro, ovvero evita che l'utente possa navigare in posizioni precedenti a quella scelta. È opportuno però inserire le cartelle in cui si vuole predisporre la navigazione all'interno di un'altra cartella il cui indirizzo è specificato nel file PHP che fa parte del plugin.

Utilizzo & Download

Utilizzare Nenav è semplice, per prima cosa è necessario includere la libreria jQuery e la libreria Prettify, dopodichè si aggiunge il file JavaScript di Nenav. Il tutto all'interno del tag della pagina:

<script type="text/javascript" src="js/jquery-2.2.1.min.js"></script>
<script type="text/javascript" src="js/prettify.js"></script>
<script type="text/javascript" src="js/nenav.js"></script> <!-- Nenav JS -->

Dopo aver aggiunto i file JavaScript si aggiunge l'eventuale tema di Prettify e il tema di Nenav. In questo caso viene aggiunto il tema di default bootstrap-light.

<link rel='stylesheet' type='text/css' href='css/nenav-bootstrap-light.css'>
<link rel='stylesheet' type='text/css' href='css/prettify.css'>

L'inizializzazione di una nuova vista di Nenav avviene creando un elemento contenitore e chiamando la funzione nenav_init (). Esempio:

<div id='nenavView'></div>
<script> 
  nenav_init ('#nenavView', { init_path: 'nenav' });
</script>

La funzione nenav_init () è composta nel seguente modo:

nenav_init (elemento, proprietà)

{
  /* Obbligatoria. Identifica la cartella di origine da cui inizia la navigazione */
  init_path: 'root', 
  /* Facoltativa. Se all'avvio si vuole iniziare la navigazione da una sotto
     cartella relativa a quella di origine. Default: null */
  curr_pos: 'subpath/of/root',
  /* Facoltativa. Indica il tipo di ordinamento dei file all'avvio. Default: name. 
     Valori Possibili: name, size, time, name-reverse, size-reverse, time-reverse. */
  sort: 'size-reverse',
  /* Facoltativa. Indica la cartella in cui è presente il file nenav.php. Default: php */
  php_path: 'php', 
  /* Facoltativa. Indica la cartella in cui è presente il file nenav-ui.html. Default: html */
  ui_path: 'html' 
}

È possibile visualizzare il file di esempio per utilizzare Nenav nell'archivio non compresso.

Per finire la configurazione potrebbe essere necessario configurare il file PHP nella variabile:

$nenav_prefix = '../nav_path';

Per motivi di sicurezza Nenav impedisce di utilizzare percorsi contenenti . o .. tramite il codice javascript, per questo motivo è necessario impostare un eventuale percorso contenente questi valori nella variabile presente direttamente nel file PHP. Il percorso così inserito non deve contenere il carattere / finale, così come anche nel codice javascript bisogna ometterlo.

Scarica nenav.tar.bz2 Scarica nenav-minify.tar.bz2

Temi

Nell'archivio di Nenav è possibile trovare quattro temi differenti, due di base ( light e dark ) e due che ricalcano lo stile dei componenti di Bootstrap. Questo è importante precisarlo, in quanto questi due temi ( bootstrap-dark e bootstrap-light ) sembrano utilizzare bootstrap ma utilizzano in realtà un file css che simula ne faccia parte.

Tema Bootstrap Light
Tema Bootstrap Dark
Tema Light
Tema Dark

Navigazione Sorgenti