Giter VIP home page Giter VIP logo

poepesquisa's Introduction

Poe Pesquisa

Esta é uma instância da ferramenta POE dedicada ao trabalho de pesquisa, direcionada para realizar fuzzy search dentro de anotações registradas por pesquisadores, e complementada por alguns outros plugins úteis para quem desempenha este tipo de trabalho.

Trata-se de um recurso já integrado ao meu POE pessoal, que os colegas pesquisadores Rodrigo Medeiros e Rafael de Castro Andrade (Ancara) solicitaram que fosse compartilhado com os demais pesquisadores.

O core do POE foi modificado para que o meu plugin de anotações se tornasse seu centro, e a ferramenta de bookmarks viesse a se tornar um plugin. Todo o resto funciona como o padrão, podendo ser complementado com novos plugins, e obedecendo os mesmos princípios do POE original.

Como eu posso usar?

Há duas formas de usar o Poe Pesquisa: você pode utilizá-lo diretamente do https://poepesquisa.vercel.app, ou se possuir um webserver próprio, pode clonar ou baixar os arquivos do github e colocá-lo diretamente no seu site ou servidor. A ferramenta não usa nenhum recurso especial; ela é feita com html, css e javascript puros.

Para usar a versão que já está online com seus próprios dados, você precisará indicá-los na própria URL da ferramenta, seja a disponível em https://poepesquisa.vercel.app ou naquela que você mesmo hospedar no seu webserver (exceto se alterar o código fonte para já usar seus dados inicialmente).

O POE Pesquisa recebe estes dados no formato JSON, e o mecanismo mais simples para suprí-los é utilizando uma planilha do Google Sheets, e usando o Open Sheets para convertê-los em JSON. Isso é mais simples do que parece!

  1. Na sua planilha, defina o compartilhamento como "Todos com o link podem ver";
  2. Observe a URL completa da sua planilha (ex. https://docs.google.com/spreadsheets/d/1okckpGqePCElNUE8bTHaBFqMJpg8xILjBFQmdDqBAG8/edit#gid=444640757 ) e identifique o ID, que é a sequência de números e letras depois do /d/ e antes do /edit, que neste caso será 1okckpGqePCElNUE8bTHaBFqMJpg8xILjBFQmdDqBAG8. Verifique também o nome da aba onde estão os dados na planilha, que nesta indicada é "Notas".
  3. Seus dados serão exportados para JSON através do link https://opensheet.elk.sh/ ID DA PLANILHA / NOME DA ABA, que neste caso será https://opensheet.elk.sh/1okckpGqePCElNUE8bTHaBFqMJpg8xILjBFQmdDqBAG8/Notas (se clicar na URL, verá os dados convertidos para JSON!)
  4. Informe este link para o POE Pesquisa através da variável de URL json, da seguinte forma: https://poepesquisa.vercel.app/?json=https://opensheet.elk.sh/1okckpGqePCElNUE8bTHaBFqMJpg8xILjBFQmdDqBAG8/Notas

A planilha (ou o JSON) precisarão ter os mesmos campos presentes neste exemplo, isto é:

Título Descrit Tags Ref Link Metatags

(Metatags ficam invisíveis, mas continuam sendo um critério para filtrar as informações)

Se desejar tirar uma cópia da planilha base, basta clicar aqui

Mais três outras planilhas podem ser úteis: uma com a relação de textos (livros, artigos, etc.) com seus respectivos links; outra com arquivos online (planilhas, docs, códigos, etc.) em que você esteja trabalhando e precisará acessar rapidamente; e uma terceira com opções para um menu superior, para acessar as funções de forma mais simples. Cada uma destas planilhas pode ser um arquivo independente, mas no exemplo preferimos colocá-las todas juntas no mesmo Google Sheets (é você quem decide como se organizar).

Estes dados também são recebidos por JSON, e o procedimento para idincá-los é o mesmo usado para indicar as anotações, só que através de variáveis de URL diferentes:

Para os textos, utilizaremos a variável textos, utilizando o link https://opensheet.elk.sh/1okckpGqePCElNUE8bTHaBFqMJpg8xILjBFQmdDqBAG8/Textos, resultando nessa URL para o POE Pesquisa:

https://poepesquisa.vercel.app/?json=https://opensheet.elk.sh/1okckpGqePCElNUE8bTHaBFqMJpg8xILjBFQmdDqBAG8/Notas&textos=https://opensheet.elk.sh/1okckpGqePCElNUE8bTHaBFqMJpg8xILjBFQmdDqBAG8/Textos

Para os arquivos, utilizaremos a variável files, com o o link https://opensheet.elk.sh/1okckpGqePCElNUE8bTHaBFqMJpg8xILjBFQmdDqBAG8/Arquivos, resultando nessa URL para o POE Pesquisa:

https://poepesquisa.vercel.app/?json=https://opensheet.elk.sh/1okckpGqePCElNUE8bTHaBFqMJpg8xILjBFQmdDqBAG8/Notas&textos=https://opensheet.elk.sh/1okckpGqePCElNUE8bTHaBFqMJpg8xILjBFQmdDqBAG8/Textos&files=https://opensheet.elk.sh/1okckpGqePCElNUE8bTHaBFqMJpg8xILjBFQmdDqBAG8/Arquivos

Para o menu utilizaremos a variável custommenu, com o link https://opensheet.elk.sh/1okckpGqePCElNUE8bTHaBFqMJpg8xILjBFQmdDqBAG8/CustomMenu, resultando nessa URL com todas as opções para o POE Pesquisa:

https://poepesquisa.vercel.app/?json=https://opensheet.elk.sh/1okckpGqePCElNUE8bTHaBFqMJpg8xILjBFQmdDqBAG8/Notas&textos=https://opensheet.elk.sh/1okckpGqePCElNUE8bTHaBFqMJpg8xILjBFQmdDqBAG8/Textos&files=https://opensheet.elk.sh/1okckpGqePCElNUE8bTHaBFqMJpg8xILjBFQmdDqBAG8/Arquivos&custommenu=https://opensheet.elk.sh/1okckpGqePCElNUE8bTHaBFqMJpg8xILjBFQmdDqBAG8/CustomMenu

Os dados dos textos, arquivos e menus precisam ter as mesmas estruturas apresentadas na planilha de exemplo.

Para textos:

ano tipologia titulo link palavras-chave

Para menus:

menu instruct

Para arquivos:

Name Link Type Service

Neste caso, Type pode ser vazio, embed ou self, indicando se o link abrirá em uma nova janela, dentro do POE Pesquisa, ou no lugar do POE Pesquisa (mesma janela);

Você pode criar quantas outras colunas desejar em todas as planilhas. As colunas mínimas estando presentes, o resto que for incluído também será usado pelo mecanismo de filtragem.

Conveniência

Você pode transformar esse site em um aplicativo com o Google Chrome (Menu > Mais Ferramentas > Criar Atalho > ✓ Abrir como janela), incluí-lo nos seus bookmarks, ou enfim, manter isso há um click de acesso da maneira como preferir.

Você pode utilizar a mesma ferramenta para manter bases de anotações diferentes, mudando apenas a URL na variável json, e inclusive manter bases compartilhadas com outros pesquisadores, podendo navegar nestes registros através do fuzzy search do POE Pesquisa.

Customizações

O POE Pesquisa funciona exatamente como a ferramenta POE. É possível customizar sua aparência (cores, fontes, etc.), e também incluir novos plugins. Os mecanismos para fazer estas customizações estão disponíveis na documentação do POE, e as modificações são também indicadas através de variáveis (css e plugins) de URL.

Se desejar implementá-lo em um servidor próprio, e quiser modificar os dados default, aqui se encontram as linhas onde deverá fazer a modificação:

CSS, linha 69 do index.html

<link rel="stylesheet" type="text/css" href="./dev/style.css" />

Base de Livros, linha 238 do index.html

let jsonlivros =
  "https://opensheet.elk.sh/1okckpGqePCElNUE8bTHaBFqMJpg8xILjBFQmdDqBAG8/Textos";

Plugins, linha 297 do index.html

     fetch(
        "https://opensheet.elk.sh/1Kot76uXzm1cU8m-53XatRs7qfoOcAudl-crgmNNc8H8/Custom"

Base de Arquivos, linha 321 do index.html

let filesjson =
  "https://opensheet.elk.sh/1okckpGqePCElNUE8bTHaBFqMJpg8xILjBFQmdDqBAG8/Arquivos";

Base de Anotações, linha 356 do index.html

       "https://opensheet.elk.sh/1okckpGqePCElNUE8bTHaBFqMJpg8xILjBFQmdDqBAG8/Notas",

poepesquisa's People

Contributors

ranoya avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.