Action

Drafts On a Timeline w/ Prompt (VisJS)

Posted by jsamlarose, Last update over 2 years ago - Unlisted

Notes:
- Essentially a mash-up of @Flohgro’s search action (https://actions.getdrafts.com/a/11Y), piping the results through visjs.
- Proof of concept for an alternative way to view drafts on a timeline (and a basis for a potential alternative to the network graphs made popular by other apps…)
- Pinned to an earlier revision of Visjs to allow aliased urls in item content/titles; circumvents xss injection protection added in newer releases, but shouldn’t be a problem running locally?

https://github.com/visjs/vis-timeline/issues/846

TODO:

  • What else might make this valuable? Tags in title attribute?
  • Grok xss security measures to allow for use of recent releases without compromising aliased URLs…

Steps

  • defineTemplateTag

    name
    frontmatter
    template
    
    
    
    
      Timeline for Drafts
      
      
      
    
    
     
    
    
    
    
    
    
    
    
    
    
    
    
  • script

    /**
     * A Javascript object to encode and/or decode html characters using HTML or Numeric entities that handles double or partial encoding
     * Author: R Reid
     * source: http://www.strictly-software.com/htmlencode
     * Licences: GPL, The MIT License (MIT)
     * Copyright: (c) 2011 Robert Reid - Strictly-Software.com
     *
     * Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
     * The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
     * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
     * 
     * Revision:
     *  2011-07-14, Jacques-Yves Bleau: 
     *       - fixed conversion error with capitalized accentuated characters
     *       + converted arr1 and arr2 to object property to remove redundancy
     *
     * Revision:
     *  2011-11-10, Ce-Yi Hio: 
     *       - fixed conversion error with a number of capitalized entity characters
     *
     * Revision:
     *  2011-11-10, Rob Reid: 
     *		 - changed array format
     *
     * Revision:
     *  2012-09-23, Alex Oss: 
     *		 - replaced string concatonation in numEncode with string builder, push and join for peformance with ammendments by Rob Reid
     */
    
    Encoder = {
    
    	// When encoding do we convert characters into html or numerical entities
    	EncodeType : "entity",  // entity OR numerical
    
    	isEmpty : function(val){
    		if(val){
    			return ((val===null) || val.length==0 || /^\s+$/.test(val));
    		}else{
    			return true;
    		}
    	},
    	
    	// arrays for conversion from HTML Entities to Numerical values
    	arr1: [' ','¡','¢','£','¤','¥','¦','§','¨','©','ª','«','¬','­','®','¯','°','±','²','³','´','µ','¶','·','¸','¹','º','»','¼','½','¾','¿','À','Á','Â','Ã','Ä','Å','Æ','Ç','È','É','Ê','Ë','Ì','Í','Î','Ï','Ð','Ñ','Ò','Ó','Ô','Õ','Ö','×','Ø','Ù','Ú','Û','Ü','Ý','Þ','ß','à','á','â','ã','ä','å','æ','ç','è','é','ê','ë','ì','í','î','ï','ð','ñ','ò','ó','ô','õ','ö','÷','ø','ù','ú','û','ü','ý','þ','ÿ','"','&','<','>','Œ','œ','Š','š','Ÿ','ˆ','˜',' ',' ',' ','‌','‍','‎','‏','–','—','‘','’','‚','“','”','„','†','‡','‰','‹','›','€','ƒ','Α','Β','Γ','Δ','Ε','Ζ','Η','Θ','Ι','Κ','Λ','Μ','Ν','Ξ','Ο','Π','Ρ','Σ','Τ','Υ','Φ','Χ','Ψ','Ω','α','β','γ','δ','ε','ζ','η','θ','ι','κ','λ','μ','ν','ξ','ο','π','ρ','ς','σ','τ','υ','φ','χ','ψ','ω','ϑ','ϒ','ϖ','•','…','′','″','‾','⁄','℘','ℑ','ℜ','™','ℵ','←','↑','→','↓','↔','↵','⇐','⇑','⇒','⇓','⇔','∀','∂','∃','∅','∇','∈','∉','∋','∏','∑','−','∗','√','∝','∞','∠','∧','∨','∩','∪','∫','∴','∼','≅','≈','≠','≡','≤','≥','⊂','⊃','⊄','⊆','⊇','⊕','⊗','⊥','⋅','⌈','⌉','⌊','⌋','⟨','⟩','◊','♠','♣','♥','♦'],
    	arr2: [' ','¡','¢','£','¤','¥','¦','§','¨','©','ª','«','¬','­','®','¯','°','±','²','³','´','µ','¶','·','¸','¹','º','»','¼','½','¾','¿','À','Á','Â','Ã','Ä','Å','Æ','Ç','È','É','Ê','Ë','Ì','Í','Î','Ï','Ð','Ñ','Ò','Ó','Ô','Õ','Ö','×','Ø','Ù','Ú','Û','Ü','Ý','Þ','ß','à','á','â','ã','ä','å','æ','ç','è','é','ê','ë','ì','í','î','ï','ð','ñ','ò','ó','ô','õ','ö','÷','ø','ù','ú','û','ü','ý','þ','ÿ','"','&','<','>','Œ','œ','Š','š','Ÿ','ˆ','˜',' ',' ',' ','‌','‍','‎','‏','–','—','‘','’','‚','“','”','„','†','‡','‰','‹','›','€','ƒ','Α','Β','Γ','Δ','Ε','Ζ','Η','Θ','Ι','Κ','Λ','Μ','Ν','Ξ','Ο','Π','Ρ','Σ','Τ','Υ','Φ','Χ','Ψ','Ω','α','β','γ','δ','ε','ζ','η','θ','ι','κ','λ','μ','ν','ξ','ο','π','ρ','ς','σ','τ','υ','φ','χ','ψ','ω','ϑ','ϒ','ϖ','•','…','′','″','‾','⁄','℘','ℑ','ℜ','™','ℵ','←','↑','→','↓','↔','↵','⇐','⇑','⇒','⇓','⇔','∀','∂','∃','∅','∇','∈','∉','∋','∏','∑','−','∗','√','∝','∞','∠','∧','∨','∩','∪','∫','∴','∼','≅','≈','≠','≡','≤','≥','⊂','⊃','⊄','⊆','⊇','⊕','⊗','⊥','⋅','⌈','⌉','⌊','⌋','〈','〉','◊','♠','♣','♥','♦'],
    		
    	// Convert HTML entities into numerical entities
    	HTML2Numerical : function(s){
    		return this.swapArrayVals(s,this.arr1,this.arr2);
    	},	
    
    	// Convert Numerical entities into HTML entities
    	NumericalToHTML : function(s){
    		return this.swapArrayVals(s,this.arr2,this.arr1);
    	},
    
    
    	// Numerically encodes all unicode characters
    	numEncode : function(s){ 
    		if(this.isEmpty(s)) return ""; 
    
    		var a = [],
    			l = s.length; 
    		
    		for (var i=0;i<l;i++){ 
    			var c = s.charAt(i); 
    			if (c < " " || c > "~"){ 
    				a.push("&#"); 
    				a.push(c.charCodeAt()); //numeric value of code point 
    				a.push(";"); 
    			}else{ 
    				a.push(c); 
    			} 
    		} 
    		
    		return a.join(""); 	
    	}, 
    	
    	// HTML Decode numerical and HTML entities back to original values
    	htmlDecode : function(s){
    
    		var c,m,d = s;
    		
    		if(this.isEmpty(d)) return "";
    
    		// convert HTML entites back to numerical entites first
    		d = this.HTML2Numerical(d);
    		
    		// look for numerical entities &#34;
    		arr=d.match(/&#[0-9]{1,5};/g);
    		
    		// if no matches found in string then skip
    		if(arr!=null){
    			for(var x=0;x<arr.length;x++){
    				m = arr[x];
    				c = m.substring(2,m.length-1); //get numeric part which is refernce to unicode character
    				// if its a valid number we can decode
    				if(c >= -32768 && c <= 65535){
    					// decode every single match within string
    					d = d.replace(m, String.fromCharCode(c));
    				}else{
    					d = d.replace(m, ""); //invalid so replace with nada
    				}
    			}			
    		}
    
    		return d;
    	},		
    
    	// encode an input string into either numerical or HTML entities
    	htmlEncode : function(s,dbl){
    			
    		if(this.isEmpty(s)) return "";
    
    		// do we allow double encoding? E.g will &amp; be turned into &amp;amp;
    		dbl = dbl || false; //default to prevent double encoding
    		
    		// if allowing double encoding we do ampersands first
    		if(dbl){
    			if(this.EncodeType=="numerical"){
    				s = s.replace(/&/g, "&#38;");
    			}else{
    				s = s.replace(/&/g, "&amp;");
    			}
    		}
    
    		// convert the xss chars to numerical entities ' " < >
    		s = this.XSSEncode(s,false);
    		
    		if(this.EncodeType=="numerical" || !dbl){
    			// Now call function that will convert any HTML entities to numerical codes
    			s = this.HTML2Numerical(s);
    		}
    
    		// Now encode all chars above 127 e.g unicode
    		s = this.numEncode(s);
    
    		// now we know anything that needs to be encoded has been converted to numerical entities we
    		// can encode any ampersands & that are not part of encoded entities
    		// to handle the fact that I need to do a negative check and handle multiple ampersands &&&
    		// I am going to use a placeholder
    
    		// if we don't want double encoded entities we ignore the & in existing entities
    		if(!dbl){
    			s = s.replace(/&#/g,"##AMPHASH##");
    		
    			if(this.EncodeType=="numerical"){
    				s = s.replace(/&/g, "&#38;");
    			}else{
    				s = s.replace(/&/g, "&amp;");
    			}
    
    			s = s.replace(/##AMPHASH##/g,"&#");
    		}
    		
    		// replace any malformed entities
    		s = s.replace(/&#\d*([^\d;]|$)/g, "$1");
    
    		if(!dbl){
    			// safety check to correct any double encoded &amp;
    			s = this.correctEncoding(s);
    		}
    
    		// now do we need to convert our numerical encoded string into entities
    		if(this.EncodeType=="entity"){
    			s = this.NumericalToHTML(s);
    		}
    
    		return s;					
    	},
    
    	// Encodes the basic 4 characters used to malform HTML in XSS hacks
    	XSSEncode : function(s,en){
    		if(!this.isEmpty(s)){
    			en = en || true;
    			// do we convert to numerical or html entity?
    			if(en){
    				s = s.replace(/\'/g,"&#39;"); //no HTML equivalent as &apos is not cross browser supported
    				s = s.replace(/\"/g,"&quot;");
    				s = s.replace(/</g,"&lt;");
    				s = s.replace(/>/g,"&gt;");
    			}else{
    				s = s.replace(/\'/g,"&#39;"); //no HTML equivalent as &apos is not cross browser supported
    				s = s.replace(/\"/g,"&#34;");
    				s = s.replace(/</g,"&#60;");
    				s = s.replace(/>/g,"&#62;");
    			}
    			return s;
    		}else{
    			return "";
    		}
    	},
    
    	// returns true if a string contains html or numerical encoded entities
    	hasEncoded : function(s){
    		if(/&#[0-9]{1,5};/g.test(s)){
    			return true;
    		}else if(/&[A-Z]{2,6};/gi.test(s)){
    			return true;
    		}else{
    			return false;
    		}
    	},
    
    	// will remove any unicode characters
    	stripUnicode : function(s){
    		return s.replace(/[^\x20-\x7E]/g,"");
    		
    	},
    
    	// corrects any double encoded &amp; entities e.g &amp;amp;
    	correctEncoding : function(s){
    		return s.replace(/(&amp;)(amp;)+/,"$1");
    	},
    
    
    	// Function to loop through an array swaping each item with the value from another array e.g swap HTML entities with Numericals
    	swapArrayVals : function(s,arr1,arr2){
    		if(this.isEmpty(s)) return "";
    		var re;
    		if(arr1 && arr2){
    			//ShowDebug("in swapArrayVals arr1.length = " + arr1.length + " arr2.length = " + arr2.length)
    			// array lengths must match
    			if(arr1.length == arr2.length){
    				for(var x=0,i=arr1.length;x<i;x++){
    					re = new RegExp(arr1[x], 'g');
    					s = s.replace(re,arr2[x]); //swap arr1 item with matching item from arr2	
    				}
    			}
    		}
    		return s;
    	},
    
    	inArray : function( item, arr ) {
    		for ( var i = 0, x = arr.length; i < x; i++ ){
    			if ( arr[i] === item ){
    				return i;
    			}
    		}
    		return -1;
    	}
    
    }
  • script

    // the search here is basically @flohgro's "search in Drafts action" (https://actions.getdrafts.com/a/11Y)...
    
    // search drafts
    const searchTypes = ["in titles", "in content", "as regex", "in tags"];
    var foundDrafts = [];
    var runSearch = true;
    var searchTypeDescriptor = "";
    
    
    function queryByTitle(query) {
      let searchResults = [];
      let allDrafts = Draft.query(query, "all", [], [], "modified", true, true);
      for (d of allDrafts) {
        if (d.title.includes(query)) {
          searchResults.push(d);
        }
      }
      return searchResults;
    }
    
    function queryByString(query) {
      let searchResults = Draft.query(query, "all", [], [], "modified", true, true);
      return searchResults;
    }
    
    
    function queryByRegex(query) {
      let searchResults = [];
    
      let allDrafts = Draft.query("", "all", [], [], "modified", true, true);
    
      for (d of allDrafts) {
        if (d.content.match(query)) {
          searchResults.push(d);
        }
      }
      return searchResults;
    }
    
    function queryByTags(query, isTagSearch) {
      let searchResults = [];
    
      if (isTagSearch) {
        let allDrafts = Draft.query("", "all", [], [], "modified", true, true);
        for (d of allDrafts) {
          for (tag of d.tags) {
            if (tag.includes(query)) {
              if (!searchResults.includes(tag)) {
                searchResults.push(tag);
              }
            }
          }
        }
      } else {
        let allDrafts = Draft.query("", "all", [query], [], "modified", true, true);
        for (d of allDrafts) {
          searchResults.push(d);
        }
      }
    
      return searchResults;
    }
    
    
    function selectFoundTag(tagsList) {
      tagsList.sort();
      let pSelectTag = Prompt.create();
      for (tag of tagsList) {
        pSelectTag.addButton(tag);
      }
      if (pSelectTag.show()) {
        return pSelectTag.buttonPressed;
      } else {
        return "NO TAG SELECTED";
      }
    }
    
    function searchAgain(msg){
    	let pSearchAgain = Prompt.create();
    	pSearchAgain.title = "search again?"
    	pSearchAgain.message = "because " + msg;
    	pSearchAgain.addButton("YES",true);
    	pSearchAgain.addButton("NO",false);
    	pSearchAgain.isCancellable = false;
    	pSearchAgain.show();
    	return pSearchAgain.buttonPressed;
    
    }
    
    
    
    function selectResultToOpen(foundDrafts) {
      pOpenDraft = Prompt.create();
      pOpenDraft.title = "select draft to open";
    
      for (d of foundDrafts) {
        pOpenDraft.addButton(d.title, d);
      }
    
      if (pOpenDraft.show()) {
        editor.load(pOpenDraft.buttonPressed);
        runSearch = false;
      } else {
    	runSearch = searchAgain("you did not select to open a draft in the " +         searchTypeDescriptor + " search");
      }
    
    }
    
    function performSearch() {
      // prompt which search
      pSearchBy = Prompt.create();
      pSearchBy.title = "search for";
    
      pSearchBy.addTextField("query", "", "", {
        "wantsFocus": true
      });
    
      for (searchType of searchTypes) {
        pSearchBy.addButton(searchType);
      }
    
    
    
      if (pSearchBy.show()) {
        let query = pSearchBy.fieldValues["query"];
        if (query == "") {
          context.fail("no search query was entered");
          app.displayErrorMessage("no search query was entered");
        } else {
          switch (pSearchBy.buttonPressed) {
            case "in titles":
            	searchTypeDescriptor = "title";
              foundDrafts = queryByTitle(query);
              break;
            case "in content":
            searchTypeDescriptor = "content";
              foundDrafts = queryByString(query);
              break;
            case "as regex":
                    searchTypeDescriptor = "regex";
              foundDrafts = queryByRegex(query);
              break;
            case "in tags":
                    searchTypeDescriptor = "tag";
              foundDrafts = queryByTags(query, true);
              if (foundDrafts.length > 0) {
                let selectedTag = selectFoundTag(foundDrafts);
                if (selectedTag == "NO TAG SELECTED") {
                  foundDrafts = [];
                  runSearch = searchAgain("you did not select a tag to query for drafts");
                } else {
                  foundDrafts = queryByTags(selectedTag, false);
                }
              }
              break;
            default:
              context.fail("searchType not implemented!");
              break;
          }
          if (foundDrafts.length > 0) {
            drafts = foundDrafts
            var GanttSpec = ""
    
    		let index = 0;
    		while(index < drafts.length){
    		   dTitle = Encoder.htmlEncode(drafts[index].displayTitle)
    		   if (dTitle.length > 70) { dTitle = dTitle.substring(0,70);}
    		   content = "<a href='" + drafts[index].permalink + "' target='_blank'>[open]</a> " + dTitle
    		
    		   start = drafts[index].createdAt.toString("yyyy-MM-dd")
    		   
    		   GanttLine = "    { id:" + index + ", title: \"" + dTitle + "\", content: \"" + content + "\", start: \"" + start + "\"},"
    		   
    		   GanttSpec += GanttLine + "\n" 
    		  index += 1;
    		}
    		context.cancel();
           runSearch = false;
    		
    		let html = draft.getTemplateTag("frontmatter") + GanttSpec + draft.getTemplateTag("endmatter")
    		
    		let preview = HTMLPreview.create();
    		if (preview.show(html)) {
    		  // continue button was pressed
    		}
    		else {
    		  // cancel button was pressed
    		}
          } else {
          	               runSearch = searchAgain("no drafts where found with your " +         searchTypeDescriptor +  " search for \"" + query + "\"")
          }
    
        }
      } else {
        context.cancel();
        runSearch = false;
      }
    }
    
    while(runSearch){
    performSearch();
    }

Options

  • After Success Default
    Notification Info
    Log Level Info
Items available in the Drafts Directory are uploaded by community members. Use appropriate caution reviewing downloaded items before use.