이것은 소나의 주요 저장소입니다. 일반적인 설정은 LocalHost에서 sonar-server 실행 한 다음 클라이언트를 통해 Sonar와 상호 작용한다는 것입니다. http : // localhost : 9191 또는 CLI에서 실행되는 UI. CLI는이 저장소의 루트에서 ./sonar 로 호출 할 수 있으며 서버를 시작하는 데 사용됩니다.
문서 웹 사이트 에는 더 많은 문서 (WIP)가 있습니다.
Sonar는 Node.js 버전 16 이상이 필요합니다. 시스템이 이전 버전을 제공하는 경우 NVM과 같은 도구를 사용하여 최신 버전을 설치할 수 있습니다. 데비안 기반 시스템에서는 Node.js 배포판을 NodeSource에서 시도 할 수도 있습니다.
명령 줄에서 node --version 실행하여 Node.js 버전을 확인할 수 있습니다.
그런 다음 다음 명령으로 소나를 설치하십시오.
npm install -g @arsonar/server 그런 다음 sonar 명령 줄 인터페이스를 실행할 수 있습니다. 이를 통해 서버를 시작하고 명령 줄에서 서버와 상호 작용할 수 있습니다.
# show help
sonar help
# show help for specific commands
sonar help collection
# start a server
sonar start참고 : 원사 1이 권장되는 순간에 지침에 따라 설치하십시오.
# clone the sonar repository
git clone https://github.com/arso-project/sonar.git
cd sonar
# install dependencies of all workspaces
yarn
# build the typescript modules and bundle the UI
yarn run build 저장소 루트에서 ./sonar 로 소나를 시작할 수 있습니다.
sonar-tantivy 와 관련된 오류로 시작이 실패하면 Sonar-Tantivy (Sonar에 포함 된 검색 엔진)를로드하거나 재건하십시오.
yarn run rebuild:tantivy
client 와 관련된 오류로 시작이 실패하면 클라이언트를 재건하십시오.
yarn run build:client
# start the sonar server
./sonar start
# start the sonar server in dev mode
./sonar start --dev
이 저장소에는 몇 가지 예가 포함되어 있습니다. 로컬로 실행하려면 다음을 수행하십시오.
# build the typecript modules
yarn build
# start sonar
./sonar start --disable-authentication --dev
# run the example from the examples/ folder
yarn example react run ./sonar help .
Sonar는 젊은 오픈 소스 프로젝트이며 모든 종류의 공헌을 환영합니다. 우리는 일이 어떻게 작동하고 함께 모이는지에 대한 더 많은 문서와 개요를 작성하는 과정에 있습니다 (책에서).
의심 스러우면 우리에게 이야기하십시오! 예를 들어 Freenode의 #Dat (또는 Gitter를 통한 브라우저에서 IRC에서 Arso.xyz 의이 프로젝트에 대해 자세히 설명합니다.
이 repo는 다른 패키지 (여러 지점에서 상호 의존적 인)의 모노 노로 구성됩니다.
핵심 모듈 입니다 . "피드 그룹*입니다. 각 컬렉션 에는 Tantivy를 통해 검색 인덱스에 연결된 Kappa-Record-DB가 있습니다. 각 컬렉션은 원시 파일 내용을 저장하기위한 관련 하이퍼 블롭 목록이 있습니다.
Server는 CLI와 UI에서 사용하는 REST 스타일 HTTP API를 제공하여 패키지/코어의 데이터에 액세스하고 관리합니다.
클라이언트 는 JavaScript 클라이언트 라이브러리입니다. CLI와 UI 모두에서 사용됩니다. HTTP를 통해 패키지/서버와 이야기합니다.
UI는 Sonar의 데이터를 탐색하기위한 단일 페이지 응용 프로그램입니다.
CLI 는 명령 줄 응용 프로그램입니다. 컬렉션을 관리하고, 데이터베이스에 넣고, 파일을 업로드하고 다운로드하고 검색 쿼리를 만들 수 있습니다.
이 프로젝트는 차세대 검색 및 디스커버리 프로그램에서 NLNET에 의해 친절하게 지원되었습니다.