PageEditorByHackmd.jsx 14 KB

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