PageEditorByHackmd.jsx 14 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474
  1. import React from 'react';
  2. import PropTypes from 'prop-types';
  3. import { withTranslation } from 'react-i18next';
  4. import loggerFactory from '~/utils/logger';
  5. import AppContainer from '~/client/services/AppContainer';
  6. import PageContainer from '~/client/services/PageContainer';
  7. import EditorContainer from '~/client/services/EditorContainer';
  8. import { withUnstatedContainers } from './UnstatedUtils';
  9. import HackmdEditor from './PageEditorByHackmd/HackmdEditor';
  10. import { getOptionsToSave } from '~/client/util/editor';
  11. // TODO: remove this when omitting unstated is completed
  12. import {
  13. useEditorMode, useSelectedGrant, useSelectedGrantGroupId, useSelectedGrantGroupName,
  14. } from '~/stores/ui';
  15. import { useSlackChannels } from '~/stores/context';
  16. import { useIsSlackEnabled } from '~/stores/editor';
  17. const logger = loggerFactory('growi:PageEditorByHackmd');
  18. class PageEditorByHackmd extends React.Component {
  19. constructor(props) {
  20. super(props);
  21. this.state = {
  22. isInitialized: false,
  23. isInitializing: false,
  24. // for error
  25. hasError: false,
  26. errorMessage: '',
  27. errorReason: '',
  28. };
  29. this.getHackmdUri = this.getHackmdUri.bind(this);
  30. this.startToEdit = this.startToEdit.bind(this);
  31. this.resumeToEdit = this.resumeToEdit.bind(this);
  32. this.onSaveWithShortcut = this.onSaveWithShortcut.bind(this);
  33. this.hackmdEditorChangeHandler = this.hackmdEditorChangeHandler.bind(this);
  34. this.penpalErrorOccuredHandler = this.penpalErrorOccuredHandler.bind(this);
  35. }
  36. componentWillMount() {
  37. this.props.appContainer.registerComponentInstance('PageEditorByHackmd', this);
  38. }
  39. /**
  40. * return markdown document of HackMD
  41. * @return {Promise<string>}
  42. */
  43. getMarkdown() {
  44. const { t } = this.props;
  45. if (!this.state.isInitialized) {
  46. return Promise.reject(new Error(t('hackmd.not_initialized')));
  47. }
  48. return this.hackmdEditor.getValue();
  49. }
  50. /**
  51. * reset initialized status
  52. */
  53. reset() {
  54. this.setState({ isInitialized: false });
  55. }
  56. getHackmdUri() {
  57. const envVars = this.props.appContainer.getConfig().env;
  58. return envVars.HACKMD_URI;
  59. }
  60. get isResume() {
  61. const { pageContainer } = this.props;
  62. const {
  63. pageIdOnHackmd, hasDraftOnHackmd, isHackmdDraftUpdatingInRealtime,
  64. } = pageContainer.state;
  65. const isPageExistsOnHackmd = (pageIdOnHackmd != null);
  66. return (isPageExistsOnHackmd && hasDraftOnHackmd) || isHackmdDraftUpdatingInRealtime;
  67. }
  68. /**
  69. * Start integration with HackMD
  70. */
  71. async startToEdit() {
  72. const { pageContainer } = this.props;
  73. const hackmdUri = this.getHackmdUri();
  74. if (hackmdUri == null) {
  75. // do nothing
  76. return;
  77. }
  78. this.setState({
  79. isInitialized: false,
  80. isInitializing: true,
  81. });
  82. const params = {
  83. pageId: pageContainer.state.pageId,
  84. };
  85. try {
  86. const res = await this.props.appContainer.apiPost('/hackmd.integrate', params);
  87. if (!res.ok) {
  88. throw new Error(res.error);
  89. }
  90. await pageContainer.setState({
  91. pageIdOnHackmd: res.pageIdOnHackmd,
  92. revisionIdHackmdSynced: res.revisionIdHackmdSynced,
  93. });
  94. }
  95. catch (err) {
  96. pageContainer.showErrorToastr(err);
  97. this.setState({
  98. hasError: true,
  99. errorMessage: 'GROWI server failed to connect to HackMD.',
  100. errorReason: err.toString(),
  101. });
  102. }
  103. this.setState({
  104. isInitialized: true,
  105. isInitializing: false,
  106. });
  107. }
  108. /**
  109. * Start to edit w/o any api request
  110. */
  111. resumeToEdit() {
  112. this.setState({ isInitialized: true });
  113. }
  114. /**
  115. * Reset draft
  116. */
  117. async discardChanges() {
  118. const { pageContainer } = this.props;
  119. const { pageId } = pageContainer.state;
  120. try {
  121. const res = await this.props.appContainer.apiPost('/hackmd.discard', { pageId });
  122. if (!res.ok) {
  123. throw new Error(res.error);
  124. }
  125. this.props.pageContainer.setState({
  126. isHackmdDraftUpdatingInRealtime: false,
  127. hasDraftOnHackmd: false,
  128. pageIdOnHackmd: res.pageIdOnHackmd,
  129. remoteRevisionId: res.revisionIdHackmdSynced,
  130. revisionIdHackmdSynced: res.revisionIdHackmdSynced,
  131. });
  132. }
  133. catch (err) {
  134. logger.error(err);
  135. pageContainer.showErrorToastr(err);
  136. }
  137. }
  138. /**
  139. * save and update state of containers
  140. * @param {string} markdown
  141. */
  142. async onSaveWithShortcut(markdown) {
  143. const {
  144. isSlackEnabled, slackChannels, pageContainer, editorContainer, grant, grantGroupId, grantGroupName,
  145. } = this.props;
  146. const optionsToSave = getOptionsToSave(isSlackEnabled, slackChannels, grant, grantGroupId, grantGroupName, editorContainer);
  147. try {
  148. // disable unsaved warning
  149. editorContainer.disableUnsavedWarning();
  150. // eslint-disable-next-line no-unused-vars
  151. const { page, tags } = await pageContainer.save(markdown, this.props.editorMode, optionsToSave);
  152. logger.debug('success to save');
  153. pageContainer.showSuccessToastr();
  154. // update state of EditorContainer
  155. editorContainer.setState({ tags });
  156. }
  157. catch (error) {
  158. logger.error('failed to save', error);
  159. pageContainer.showErrorToastr(error);
  160. }
  161. }
  162. /**
  163. * onChange event of HackmdEditor handler
  164. */
  165. async hackmdEditorChangeHandler(body) {
  166. const hackmdUri = this.getHackmdUri();
  167. const { pageContainer, editorContainer } = this.props;
  168. if (hackmdUri == null) {
  169. // do nothing
  170. return;
  171. }
  172. // do nothing if contents are same
  173. if (pageContainer.state.markdown === body) {
  174. return;
  175. }
  176. // enable unsaved warning
  177. editorContainer.enableUnsavedWarning();
  178. const params = {
  179. pageId: pageContainer.state.pageId,
  180. };
  181. try {
  182. await this.props.appContainer.apiPost('/hackmd.saveOnHackmd', params);
  183. }
  184. catch (err) {
  185. logger.error(err);
  186. }
  187. }
  188. penpalErrorOccuredHandler(error) {
  189. const { pageContainer, t } = this.props;
  190. pageContainer.showErrorToastr(error);
  191. this.setState({
  192. hasError: true,
  193. errorMessage: t('hackmd.fail_to_connect'),
  194. errorReason: error.toString(),
  195. });
  196. }
  197. renderPreInitContent() {
  198. const hackmdUri = this.getHackmdUri();
  199. const { pageContainer, t } = this.props;
  200. const {
  201. revisionId, revisionIdHackmdSynced, remoteRevisionId, pageId,
  202. } = pageContainer.state;
  203. const isPageNotFound = pageId == null;
  204. let content;
  205. /*
  206. * HackMD is not setup
  207. */
  208. if (hackmdUri == null) {
  209. content = (
  210. <div>
  211. <p className="text-center hackmd-status-label"><i className="fa fa-file-text"></i> { t('hackmd.not_set_up')}</p>
  212. {/* eslint-disable-next-line react/no-danger */}
  213. <p dangerouslySetInnerHTML={{ __html: t('hackmd.need_to_associate_with_growi_to_use_hackmd_refer_to_this') }} />
  214. </div>
  215. );
  216. }
  217. /*
  218. * used HackMD from NotFound Page
  219. */
  220. else if (isPageNotFound) {
  221. content = (
  222. <div className="text-center">
  223. <p className="hackmd-status-label">
  224. <i className="fa fa-file-text mr-2" />
  225. { t('hackmd.used_for_not_found') }
  226. </p>
  227. {/* eslint-disable-next-line react/no-danger */}
  228. <p dangerouslySetInnerHTML={{ __html: t('hackmd.need_to_make_page') }} />
  229. </div>
  230. );
  231. }
  232. /*
  233. * Resume to edit or discard changes
  234. */
  235. else if (this.isResume) {
  236. const isHackmdDocumentOutdated = revisionIdHackmdSynced !== remoteRevisionId;
  237. content = (
  238. <div>
  239. <p className="text-center hackmd-status-label"><i className="fa fa-file-text"></i> HackMD is READY!</p>
  240. <p className="text-center"><strong>{t('hackmd.unsaved_draft')}</strong></p>
  241. { isHackmdDocumentOutdated && (
  242. <div className="card border-warning">
  243. <div className="card-header bg-warning"><i className="icon-fw icon-info"></i> {t('hackmd.draft_outdated')}</div>
  244. <div className="card-body text-center">
  245. {t('hackmd.based_on_revision')}&nbsp;
  246. <a href={`?revision=${revisionIdHackmdSynced}`}><span className="badge badge-secondary">{revisionIdHackmdSynced.substr(-8)}</span></a>
  247. <div className="text-center mt-3">
  248. <button
  249. className="btn btn-link btn-view-outdated-draft p-0"
  250. type="button"
  251. disabled={this.state.isInitializing}
  252. onClick={() => { return this.resumeToEdit() }}
  253. >
  254. {t('hackmd.view_outdated_draft')}
  255. </button>
  256. </div>
  257. </div>
  258. </div>
  259. ) }
  260. { !isHackmdDocumentOutdated && (
  261. <div className="text-center hackmd-resume-button-container mb-3">
  262. <button
  263. className="btn btn-success btn-lg waves-effect waves-light"
  264. type="button"
  265. disabled={this.state.isInitializing}
  266. onClick={() => { return this.resumeToEdit() }}
  267. >
  268. <span className="btn-label"><i className="icon-fw icon-control-end"></i></span>
  269. <span className="btn-text">{t('hackmd.resume_to_edit')}</span>
  270. </button>
  271. </div>
  272. ) }
  273. <div className="text-center hackmd-discard-button-container mb-3">
  274. <button
  275. className="btn btn-outline-secondary btn-lg waves-effect waves-light"
  276. type="button"
  277. onClick={() => { return this.discardChanges() }}
  278. >
  279. <span className="btn-label"><i className="icon-fw icon-control-start"></i></span>
  280. <span className="btn-text">{t('hackmd.discard_changes')}</span>
  281. </button>
  282. </div>
  283. </div>
  284. );
  285. }
  286. /*
  287. * Start to edit
  288. */
  289. else {
  290. const isRevisionOutdated = revisionId !== remoteRevisionId;
  291. content = (
  292. <div>
  293. <p className="text-muted text-center hackmd-status-label"><i className="fa fa-file-text"></i> HackMD is READY!</p>
  294. <div className="text-center hackmd-start-button-container mb-3">
  295. <button
  296. className="btn btn-info btn-lg waves-effect waves-light"
  297. type="button"
  298. disabled={isRevisionOutdated || this.state.isInitializing}
  299. onClick={() => { return this.startToEdit() }}
  300. >
  301. <span className="btn-label"><i className="icon-fw icon-paper-plane"></i></span>
  302. {t('hackmd.start_to_edit')}
  303. </button>
  304. </div>
  305. <p className="text-center">{t('hackmd.clone_page_content')}</p>
  306. </div>
  307. );
  308. }
  309. return (
  310. <div className="hackmd-preinit d-flex justify-content-center align-items-center">
  311. {content}
  312. </div>
  313. );
  314. }
  315. render() {
  316. const hackmdUri = this.getHackmdUri();
  317. const { pageContainer, t } = this.props;
  318. const {
  319. markdown, pageIdOnHackmd,
  320. } = pageContainer.state;
  321. let content;
  322. if (this.state.isInitialized) {
  323. content = (
  324. <HackmdEditor
  325. ref={(c) => { this.hackmdEditor = c }}
  326. hackmdUri={hackmdUri}
  327. pageIdOnHackmd={pageIdOnHackmd}
  328. initializationMarkdown={this.isResume ? null : markdown}
  329. onChange={this.hackmdEditorChangeHandler}
  330. onSaveWithShortcut={(document) => {
  331. this.onSaveWithShortcut(document);
  332. }}
  333. onPenpalErrorOccured={this.penpalErrorOccuredHandler}
  334. >
  335. </HackmdEditor>
  336. );
  337. }
  338. else {
  339. content = this.renderPreInitContent();
  340. }
  341. return (
  342. <div className="position-relative">
  343. {content}
  344. { this.state.hasError && (
  345. <div className="hackmd-error position-absolute d-flex flex-column justify-content-center align-items-center">
  346. <div className="bg-box p-5 text-center">
  347. <h2 className="text-warning"><i className="icon-fw icon-exclamation"></i> {t('hackmd.integration_failed')}</h2>
  348. <h4>{this.state.errorMessage}</h4>
  349. <p className="card well text-danger">
  350. {this.state.errorReason}
  351. </p>
  352. {/* eslint-disable-next-line react/no-danger */}
  353. <p dangerouslySetInnerHTML={{ __html: t('hackmd.check_configuration') }} />
  354. </div>
  355. </div>
  356. ) }
  357. </div>
  358. );
  359. }
  360. }
  361. /**
  362. * Wrapper component for using unstated
  363. */
  364. const PageEditorByHackmdHOCWrapper = withUnstatedContainers(PageEditorByHackmd, [AppContainer, PageContainer, EditorContainer]);
  365. const PageEditorByHackmdWrapper = (props) => {
  366. const { data: editorMode } = useEditorMode();
  367. const { data: isSlackEnabled } = useIsSlackEnabled();
  368. const { data: slackChannels } = useSlackChannels();
  369. const { data: grant } = useSelectedGrant();
  370. const { data: grantGroupId } = useSelectedGrantGroupId();
  371. const { data: grantGroupName } = useSelectedGrantGroupName();
  372. if (editorMode == null) {
  373. return null;
  374. }
  375. return (
  376. <PageEditorByHackmdHOCWrapper
  377. {...props}
  378. editorMode={editorMode}
  379. isSlackEnabled={isSlackEnabled}
  380. slackChannels={slackChannels}
  381. grant={grant}
  382. grantGroupId={grantGroupId}
  383. grantGroupName={grantGroupName}
  384. />
  385. );
  386. };
  387. PageEditorByHackmd.propTypes = {
  388. t: PropTypes.func.isRequired, // i18next
  389. appContainer: PropTypes.instanceOf(AppContainer).isRequired,
  390. pageContainer: PropTypes.instanceOf(PageContainer).isRequired,
  391. editorContainer: PropTypes.instanceOf(EditorContainer).isRequired,
  392. // TODO: remove this when omitting unstated is completed
  393. editorMode: PropTypes.string.isRequired,
  394. isSlackEnabled: PropTypes.bool.isRequired,
  395. slackChannels: PropTypes.string.isRequired,
  396. grant: PropTypes.number.isRequired,
  397. grantGroupId: PropTypes.string,
  398. grantGroupName: PropTypes.string,
  399. };
  400. export default withTranslation()(PageEditorByHackmdWrapper);